Jeasx: потоковый серверный рендеринг на чистом JSX без клиентского рантаймаЗаметка · дайджест за 16 ноября
Современная журнальная векторная графика прямого серверного рендеринга JSX без клиентского рантайма.
Заметка2 раздела≈ 4 мин

Jeasx: потоковый серверный рендеринг на чистом JSX без клиентского рантайма

В веб-разработке уживаются две противоположные вещи. С одной стороны, JSX стал стандартом удобной вёрстки: собирать интерфейс из небольших функций с параметрами очень наглядно. С другой стороны, ради простой карточки товара браузер часто делает двойную работу: получает готовый HTML от сервера, а следом качает увесистый пакет JavaScript, чтобы заново пересобрать дерево компонентов в памяти телефона ради одной кнопки.

Когда я увидел в каталоге Best of JS открытый Node.js-фреймворк Jeasx (автор — Майк Яблонски, лицензия MIT), меня зацепила его прямота. Можно ли сохранить удобство JSX, не нагружая браузер гидратацией и лишним JavaScript? Достаточно оставить JSX работать шаблонизатором на сервере.

Почему гидратация избыточна для контента и как работает серверный JSX

Переведём термин «гидратация» (hydration) на бытовой язык. Представь, что грузчики уже поставили собранный стеллаж к стене, но следом входит бригада с чертежами и заново перекручивает каждую полку, чтобы проверить петли на дверце. Так же ведёт себя клиентская гидратация: сервер уже отдал HTML, но браузер качает рантайм, заново вызывает функции компонентов, строит в памяти виртуальную копию страницы (виртуальный DOM) и сверяет её с тегами на экране, задерживая первую отрисовку (FCP) и отклик на нажатия (TTI).

Сравним, как вывод динамического каталога решают два подхода:

  • Классический SPA-фреймворк рендерит страницу на сервере, пакует данные в JSON и тянет в браузер ядро для повторного прогона кода.
  • Серверный фреймворк Jeasx опирается на то, что JSX — лишь синтаксис вызова функций JavaScript. Сервер выполняет их один раз и отдаёт чистый HTML и CSS без клиентского JavaScript по умолчанию.

Связка Fastify, esbuild и jsx-async-runtime: потоковая сборка каталога

В ядре проекта (документация на jeasx.dev) работают сервер Fastify, компилятор esbuild и среда jsx-async-runtime. Маршруты строятся по папке routes/, а любой компонент объявляется как async. За счёт потокового рендеринга (Streaming SSR) Fastify сразу шлёт в сокет шапку <head>, пока запрос к базе ещё идёт.

Соберём страницу товара routes/products/[id].jsx, которая ищет позицию по id из URL, отдаёт статус 404 при отсутствии записи и выводит форму корзины:

// routes/products/[id].jsx — серверный маршрут в 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>
  );
}

При вызове маршрута сервер передаёт в ProductPage объекты request, reply и params. Вызов await getProductById(params.id) обращается к базе прямо из компонента без промежуточных хуков. Если запись не найдена, reply.status(404) ставит код ответа, а для найденного товара jsx-async-runtime собирает потоковый HTML со штатной формой <form method="POST">.

У полного отказа от браузерного состояния в памяти есть свой архитектурный потолок: Jeasx не рассчитан на графические редакторы или дашборды с десятками фильтров, а его плагины опираются на экосистему Fastify. Для точечной динамики поверх HTML подключают веб-компоненты или гипермедиа-библиотеки (как они обновляют DOM без перезагрузки экрана, разобрано в устройстве гипермедиа-архитектуры без тяжёлых SPA).

Не переживай, если на старте нового каталога тебе не хочется разворачивать сложную клиентскую архитектуру: собирать тяжёлый комбайн с первого дня не обязательно. Начать с простых серверных JSX-страниц и добавлять скрипты по мере нужды — спокойное решение, которое легко проверить в Jeasx Expo или на стенде jeasx-develop.

Хочу подробный разборГолоса помогают выбрать, что разобрать подробно. За этот материал 0 голосов.
Источники · 3