Как Suspense связан с рендерингом
На этой странице
Suspense - компонент React, который показывает временный интерфейс, пока поддерживающий этот механизм дочерний компонент ожидает данные или код.
Вопрос
Что делает fallback, где поставить границу Suspense и какие загрузки она умеет обнаруживать?
Основная идея
Suspense похож на выделенное место с табличкой «Готовим результат». Остальная страница может отображаться, пока содержимое этого места еще не готово.
В Next.js App Router асинхронный серверный компонент способен приостановить рендеринг на await. Ближайший родительский Suspense разрешает показать fallback, затем заменить его результатом. Это основа потоковой отправки медленных частей страницы.
На клиенте Suspense также используется, например, для загрузки компонента через React.lazy. Он не обнаруживает произвольный запрос внутри useEffect: там состояние загрузки нужно организовать самостоятельно или средствами совместимой библиотеки.
Как расставлять границы
<Page>
├─ <Header /> ← без Suspense: быстрое, всегда видно
├─ <ProductInfo /> (await getProduct) ← главное для LCP: ждём до отправки
├─ <Suspense fallback={<ReviewsSkeleton/>}> ← второстепенное, медленное
│ <Reviews />
└─ <Suspense fallback={<RecsSkeleton/>}> ← независимое от отзывов
<Recommendations />| Решение | Эффект |
|---|---|
Одна граница на всю страницу (loading.tsx) | Быстрый скелетон при переходе, но всё появляется вместе |
| Граница на каждый медленный блок | Блоки появляются независимо |
| Слишком много мелких границ | Эффект «попкорна»: экран дёргается от появляющихся кусочков |
| Связанные блоки в одной границе | Появляются согласованно |
| Fallback того же размера, что контент | Нет сдвигов макета (CLS) |
Что Suspense «видит», а что нет
| Источник ожидания | Suspense покажет fallback? |
|---|---|
await в async Server Component | Да |
use(promise) в клиентском компоненте | Да |
React.lazy / next/dynamic | Да |
useSuspenseQuery (TanStack Query) | Да |
fetch внутри useEffect | Нет — это обычное состояние компонента |
Пример: независимое ожидание одного блока
Пример для App Router без включенного cacheComponents:
// app/report/page.tsx
import { Suspense } from "react";
import { connection } from "next/server";
async function Report() {
await connection();
const count = await new Promise<number>(resolve => {
setTimeout(() => resolve(42), 1500);
});
return <p>Заказов за сегодня: {count}</p>;
}
export default function Page() {
return (
<main>
<h1>Отчет магазина</h1>
<Suspense fallback={<p role="status">Считаем заказы…</p>}>
<Report />
</Suspense>
<p>Данные приведены для ознакомления.</p>
</main>
);
}connection() переносит работу блока на запрос. Promise с таймером имитирует медленный подсчет и возвращает учебное число 42. Заголовок и пояснение доступны, пока отчет ожидает; затем сообщение загрузки заменяется результатом.
Что важно помнить
Граница должна находиться выше компонента, который ожидает. Если Page сначала сама выполнит подсчет, а потом вернет Suspense, данный fallback это ожидание не прикроет.
Одна граница объединяет ожидание своего содержимого. Несколько границ позволяют частям страницы появляться независимо. Делить каждый маленький элемент не обязательно: выбирай понятные пользователю блоки.
Для ошибок нужен механизм обработки ошибок, например error.tsx; fallback Suspense описывает ожидание и не заменяет полноценный интерфейс ошибки.
Мини-шпаргалка
- Suspense управляет ожиданием, а не выбирает SSG или SSR.
fallbackпоказывает временный интерфейс.- Запрос в обычном
useEffectсам по себе не активирует Suspense. loading.tsxсоздает границу на уровне маршрута.