Adopción del modo concurrente (Experimental)

Advertencia:

Esta página describe funcionalidades experimentales que aún no están disponibles en una versión estable. No dependas de compilados experimentales de React en aplicaciones en producción. Estas funcionalidades pueden cambiar significativamente y sin advertencia antes de formar parte de React. Esta documentación está dirigida a usuarios pioneros y personas que sienten curiosidad. Si te estás iniciando en React, no te preocupes por estas funcionalidades, no necesitas aprenderlas inmediatamente.

Instalación

El Modo Concurrente solo está disponible en compilados experimentales de React. Para instalarlos, ejecuta:

npm install react@experimental react-dom@experimental

No hay garantías de versionado semántico para los compilados experimentales.
Se puede añadir, cambiar o eliminar las API en cualquier versión @experimental.

Las versiones experimentales tendrán frecuentes cambios disruptivos.

Puedes probar estos compilados en proyectos personales o en una rama, pero no recomendamos ejecutarlos en producción. En Facebook, los ejecutamos en producción, pero solo porque también estamos ahí para solucionar los errores cuando algo se rompe. ¡Has sido advertido!

¿Para quién es la versión experimental?

Esta versión está dirigida principalmente a los pioneros, autores de bibliotecas y gente curiosa.

Estamos usando este código en producción (y nos funciona), pero aún existen algunos errores, funcionalidades que faltan, y lagunas en la documentación. Nos gustaría escuchar más acerca de qué se rompe en el Modo Concurrente para que lo podamos preparar mejor para una versión oficial estable en el futuro.

Habilitar el Modo Concurrente

Normalmente, cuando añadimos nuevas funcionalidades a React, puedes comenzar a usarlas inmediantamente. Los Fragmentos, el contexto, e incluso los Hooks son ejemplos de tales funcionalidades. Las puedes usar en código nuevo sin hacer ningún cambio al código existente.

El Modo Concurrente es diferente. Introduce cambios semánticos a cómo React funciona. De otra forma, las nuevas funcionalidades que se habilitan no serían posibles. Es por eso que están agrupadas en un nuevo “modo” en lugar de ser lanzadas una por una por separado.

No puedes optar por el Modo Concurrente en base a subárboles. En cambio, para optar por él, tienes que hacerlo en el lugar donde hoy llamas a ReactDOM.render().

Esto habilitará el Modo Concurrente para todo el árbol <App /> :

import ReactDOM from 'react-dom';

// Si anteriormente tenías:
//
// ReactDOM.render(<App />, document.getElementById('root'));
//
// Puedes optar por el modo concurrente escribiendo:

ReactDOM.unstable_createRoot(
  document.getElementById('root')
).render(<App />);

Nota:

Las API del Modo Concurrente como createRoot solo existen en los compilados experimentadles de React.

En el Modo Concurrente, los métodos de ciclo de vida previamente marcados como “inseguros” de hecho son inseguros, y conducen aún a más errores que en React hoy en día. No recomendamos intentar el Modo Concurrente hasta que tu aplicación sea compatible con el Modo estricto.

¿Qué esperar?

Si tienes una aplicación grande existente, o si tu aplicación depende de muchos paquetes de terceros, por favor no esperes que seas capaz de usar el Modo Concurrente de forma inmediata. Por ejemplo, en Facebook estamos usando el Modo concurrente para el nuevo sitio web, pero no tenemos planeado habilitarlo en el sitio antiguo. Esto ocurre porque nuestro antiguo sitio web aún utiliza métodos de ciclo de vida inseguros en el código del producto, bibliotecas de terceros incompatibles y patrones que no funcionan bien en el Modo Concurrente.

En nuestra experiencia, el código que usa patrones idiomáticos de React y que no depende de soluciones del manejo de estado de forma externa es el más fácil de conseguir que se ejecute en el Modo Concurrente. Describiremos los problemas comunes que hemos visto y las soluciones a ellas de forma separada en las próximas semanas.

Paso de migración: Modo de bloqueo

Para bases de código más antiguas, el Modo Concurrente pueden ser un paso que vaya demasiado lejos. Por eso es que también proporcionamos un nuevo “Modo de bloqueo” en los compilados experimentales de React. Puedes probarlos sustituyendocreateRoot con createBlockingRoot. Solo ofrece un pequeño subconjunto de la funcionalidades del Modo Concurrente, pero es más cercano a como React funciona hoy y puede servir como un paso de migración.

Para recapitular:

  • Modo legado: ReactDOM.render(<App />, rootNode). Es el que las aplicaciones de React utilizan hoy en día. No hay planes para eliminar el modo legado en el futuro cercano, pero no será capaz de incluir estas nuevas funcionalidades.
  • Modo de bloqueo: ReactDOM.createBlockingRoot(rootNode).render(<App />). Actualmente es experimental. Su intención es ser un primer paso para la migración de las aplicaciones que quieran obtener un subconjunto de las funcionalidades del Modo Concurrente.
  • Modo Concurrente: ReactDOM.createRoot(rootNode).render(<App />). . Actualmente es experimental. En el futuro, luego de que se estabilice, esperamos convertirlo en el modo predeterminado para React. Este modo habilita todas las nuevas funcionalidades.

¿Por qúe tantos modos?

Pensamos que es mejor ofrecer una estrategia gradual de migración que hacer grandes cambios disruptivos, o dejar que React se estanque hasta la irrelevancia.

En la práctica, esperamos que la mayoría de las aplicaciones que usan el Modo Legado hoy sean capaces de migrar al menos al Modo de bloqueo (si no al Modo Concurrente). Esta fragmentación puede ser molesta para las bibliotecas que se propongan ser compatibles con todos los modos a corto plazo. Sin embargo, mover gradualmente al ecosistema lejos del Modo Legado, también resolverá problemas que afectan a bibliotecas importantes en el ecosistema, como el comportamiento confuso de Suspense al leer una disposición de elementos y la falta de garantías consistentes en el procesamiento por lotes. Existen un número de errores que no pueden ser solucionados en el Modo Legado sin cambiar semánticas, pero que no existen en el Modo de bloqueo o el Concurrente.

Puedes hacerte la idea del Modo de bloqueo como una versión “graciosamente degradada” del Modo Concurrente. Como resultado, a largo plazo debemos ser capaces de converger y parar de pensar de una vez por todas acerca de los distintos Modos. Pero por ahora, los modos son una estrategia importante de migración. Le permiten a todos decidir cuándo vale la pena migrar, y realizar las actualizaciones a su propio paso.

Comparación de funcionalidades

Modo Heredado Modo Bloqueo Modo Concurrente
String Refs 🚫** 🚫**
Legacy Context 🚫** 🚫**
findDOMNode 🚫** 🚫**
Suspense
SuspenseList 🚫
Suspense SSR + Hydration 🚫
Progressive Hydration 🚫
Selective Hydration 🚫 🚫
Cooperative Multitasking 🚫 🚫
Automatic batching of multiple setStates     🚫*
Priority-based Rendering 🚫 🚫
Interruptible Prerendering 🚫 🚫
useTransition 🚫 🚫
useDeferredValue 🚫 🚫
Suspense Reveal “Train” 🚫 🚫

*: El modo legado tiene procesamiento por lotes automático en los eventos manejados por React, pero está limitado a una tarea del navegador. Los eventos que no son de React deben optar por ese comportamiento usando unstable_batchedUpdates. En el Modo de bloqueo y el concurrente, todos los setState son procesados en lote de forma predeterminada.

**: Muestra advertencias en desarrollo.

¿Es útil esta página?Edita esta página