Jeasx: renderizado en servidor por streaming con JSX puro sin runtime en el clienteNota · digest del 16 de noviembre
Gráfico vectorial editorial moderno del renderizado directo en servidor con JSX sin runtime en el cliente.
Nota2 secciones≈ 5 min

Jeasx: renderizado en servidor por streaming con JSX puro sin runtime en el cliente

En el desarrollo web conviven dos ideas opuestas. Por un lado, JSX se ha vuelto el estándar para maquetar cómodo: componer una interfaz a base de pequeñas funciones con parámetros resulta muy claro. Por otro, para pintar una simple tarjeta de producto, el navegador suele hacer doble trabajo: recibe HTML listo desde el servidor y acto seguido descarga un paquete pesado de JavaScript para reconstruir todo el árbol de componentes en la memoria del teléfono solo por un botón.

Cuando vi en el catálogo Best of JS el framework abierto de Node.js Jeasx (creado por Mike Jablonski bajo licencia MIT), me enganchó su franqueza. ¿Se puede mantener la comodidad de JSX sin cargar el navegador con hidratación ni JavaScript sobrante? Basta con dejar que JSX trabaje como motor de plantillas en el servidor.

Por qué sobra la hidratación en sitios de contenido y cómo funciona el JSX de servidor

Traduzcamos el término «hidratación» (hydration) a un lenguaje cotidiano. Imagina que los de la mudanza ya han dejado una estantería montada contra la pared, pero detrás entra otra cuadrilla con planos para volver a atornillar cada balda y comprobar las bisagras. Así actúa la hidratación en el cliente: el servidor ya entregó el HTML, pero el navegador descarga un runtime, vuelve a ejecutar las funciones de los componentes, levanta en memoria una copia virtual de la página (el DOM virtual) y la compara con las etiquetas de la pantalla, retrasando el primer pintado (FCP) y el tiempo hasta la interactividad (TTI).

Comparemos cómo resuelven la salida de un catálogo dinámico ambos enfoques:

  • Un framework SPA clásico renderiza la página en el servidor, empaqueta los datos en JSON y arrastra al navegador un núcleo para reejecutar el código.
  • El framework de servidor Jeasx aprovecha que JSX es solo sintaxis para invocar funciones de JavaScript. El servidor las ejecuta una sola vez y envía HTML y CSS puros sin JavaScript de cliente por defecto.

En el núcleo del proyecto (documentación en jeasx.dev) trabajan el servidor Fastify, el compilador esbuild y el entorno jsx-async-runtime. Las rutas se organizan según la carpeta routes/ y cualquier componente se declara como async. Gracias al renderizado por streaming (Streaming SSR), Fastify envía al socket la cabecera <head> de inmediato mientras la consulta a la base de datos sigue en curso.

Construyamos la página de producto routes/products/[id].jsx, que busca el artículo por el id de la URL, devuelve estado 404 si no existe y muestra el formulario del carrito:

// routes/products/[id].jsx — ruta de servidor en Node.js
export default async function ProductPage({ request, reply, params }) {
  const product = await getProductById(params.id);
  if (!product) {
    reply.status(404);
    return <h1>Товар не найден</h1>;
  }
  return (
    <html lang="ru">
      <head>
        <title>{product.title} — Каталог</title>
        <link rel="stylesheet" href="/assets/style.css" />
      </head>
      <body>
        <main class="product-card">
          <h1>{product.title}</h1>
          <p class="price">{product.price} ₽</p>
          <div class="description">{product.description}</div>
          <form method="POST" action={`/api/cart/add?id=${product.id}`}>
            <button type="submit">Добавить в корзину</button>
          </form>
        </main>
      </body>
    </html>
  );
}

Al invocar la ruta, el servidor pasa a ProductPage los objetos request, reply y params. La llamada await getProductById(params.id) consulta la base directamente desde el componente sin hooks intermedios. Si no encuentra registro, reply.status(404) fija el código de respuesta; si existe, jsx-async-runtime genera el HTML en streaming con un formulario estándar <form method="POST">.

Renunciar por completo al estado en la memoria del navegador tiene un techo arquitectónico claro: Jeasx no está pensado para editores gráficos ni cuadros de mando con decenas de filtros, y sus plugins dependen del ecosistema de Fastify. Para añadir dinamismo puntual sobre el HTML se conectan Web Components o librerías hipermedia (cómo actualizan el DOM sin recargar la pantalla lo vimos en el análisis de la arquitectura hipermedia sin SPAs pesadas).

No te agobies si al arrancar un catálogo nuevo no te apetece desplegar una arquitectura de cliente compleja: no hace falta montar una cosechadora pesada desde el primer día. Empezar con páginas JSX sencillas en el servidor e ir sumando scripts solo cuando hagan falta es una decisión tranquila que puedes probar al instante en Jeasx Expo o en el entorno jeasx-develop.

Quiero un análisis detalladoLos votos ayudan a elegir qué analizar a fondo. Este material tiene 0 votos.
Fuentes · 3