Что такое streaming rendering
На этой странице
Streaming rendering, потоковый рендеринг, - отправка готовых частей интерфейса по мере их появления, без ожидания самого медленного блока страницы.
Вопрос
Как показать заголовок сразу, а медленные данные добавить позднее в рамках того же ответа?
Основная идея
Представь страницу книги: описание уже известно, а отзывы загружаются две секунды. Если ждать все данные перед отправкой ответа, пользователь не увидит даже готовое описание. Streaming позволяет отправить его вместе с обозначением загрузки отзывов.
Когда отзывы готовы, сервер передает следующую часть, и React обновляет нужное место страницы. Для такого разделения используют Suspense: он задает границу ожидания и временный интерфейс fallback.
Streaming совместим с серверным рендерингом. Это способ постепенно доставлять результат, а не замена SSR.
Без стриминга и со стримингом
Без стриминга: сервер ждёт ВСЕ данные
getBook 100мс ─┐
getReviews 2000мс ───────────────────┐
└─▶ HTML целиком (TTFB ≈ 2,1 с)
Со стримингом: оболочка сразу, медленное — потом в том же ответе
─▶ <html>…<h1>Книга</h1>…<div>Загружаем отзывы…</div> (TTFB ≈ 0,1 с)
⋯ 2 с ⋯
─▶ <div hidden id="S:0">…отзывы…</div><script>заменить fallback</script>| Без стриминга | Со стримингом | |
|---|---|---|
| Первый байт | После самого медленного запроса | Сразу после быстрых данных |
| Что видит пользователь | Белый экран, потом всё | Оболочка и главное, потом остальное |
| Гидратация | Вся страница разом | По частям, по мере прихода |
| HTTP-статус | Можно выбрать в конце | Уходит с первыми байтами — 404/редирект до стриминга |
Как включить в App Router: loading.tsx (граница для всей страницы) или <Suspense fallback> вокруг медленного блока.
Пример: медленный блок отзывов
Пример для App Router без включенного cacheComponents:
// app/book/page.tsx
import { Suspense } from "react";
import { connection } from "next/server";
async function Reviews() {
await connection();
await new Promise(resolve => setTimeout(resolve, 2000));
return <p>Отзыв: понятная книга с хорошими примерами.</p>;
}
export default function Page() {
return (
<main>
<h1>Учебник React</h1>
<p>Практическое введение в компоненты.</p>
<Suspense fallback={<p>Загружаем отзывы…</p>}>
<Reviews />
</Suspense>
</main>
);
}connection() исключает последующую работу из предварительного рендеринга и переносит ее на запрос. setTimeout - учебная имитация медленного источника, в настоящем проекте здесь был бы запрос к API или базе.
Сначала пользователь может увидеть заголовок, описание и «Загружаем отзывы…». Затем появляется отзыв. Браузеры и промежуточные серверы иногда буферизуют маленькие ответы, поэтому фактическое время появления зависит и от окружения.
Что важно помнить
Если сначала выполнить медленный await в родительской странице и только затем вернуть Suspense, эта граница не сможет показать загрузку во время уже завершившегося ожидания. Ожидающая работа должна находиться внутри границы.
Streaming не ускоряет сам запрос к базе данных. Он позволяет раньше показать доступную часть интерфейса.
Файл loading.tsx создает готовую границу ожидания для страницы и ее вложенного содержимого в соответствующем сегменте.
Мини-шпаргалка
- Готовый каркас приходит раньше медленного блока.
Suspenseопределяет область ожидания.fallbackобъясняет пользователю, что загружается.- Медленную работу помещай внутрь границы.