Phone icon Связаться с нами

Веб-разработка

Что такое Suspense в React?

Suspense — это встроенный компонент React, который позволяет показать запасной интерфейс (fallback) — спиннер, скелетон или текст «Загрузка…» — пока вложенные компоненты ещё не готовы к отображению.

Сначала Suspense появился для ленивой загрузки кода: компонент, созданный через React.lazy, подгружается отдельным файлом, а Suspense показывает fallback до завершения загрузки. Позже механизм расширили на данные: библиотеки вроде TanStack Query, хук use() в React 19 и серверные компоненты Next.js могут «приостанавливать» рендер, пока данные не придут.

Границы Suspense можно вкладывать и расставлять в разных частях страницы: шапка и меню появляются сразу, а медленные блоки — отзывы, рекомендации — показывают свои скелетоны и появляются независимо. На сервере Suspense позволяет передавать HTML частями (streaming).

Где применяется

Suspense используют для ленивой загрузки страниц и тяжёлых компонентов — админ-панелей, редакторов, графиков, — загрузки данных в Next.js и с TanStack Query, потокового серверного рендеринга и плавных переходов между экранами.

Вместе с Suspense обычно используют Error Boundary: Suspense обрабатывает состояние ожидания, а граница ошибок — ситуацию, когда загрузка завершилась ошибкой.

Пример

Ленивые компоненты с отдельными запасными интерфейсами.

import { Suspense, lazy } from 'react';

const AdminPanel = lazy(() => import('./AdminPanel'));
const Reviews = lazy(() => import('./Reviews'));

function CoursePage() {
  return (
    <main>
      <h1>React course</h1>

      <Suspense fallback={<p>Loading reviews...</p>}>
        <Reviews />
      </Suspense>

      <Suspense fallback={<Spinner />}>
        <AdminPanel />
      </Suspense>
    </main>
  );
}
Suspense, lazy и fallback.

Частые вопросы

Работает ли Suspense с обычным fetch в useEffect?

Нет. Suspense срабатывает только для источников, которые умеют «приостанавливать» рендер: React.lazy, хук use() с промисом, поддерживаемые библиотеки данных и фреймворки. Обычный useEffect о Suspense не знает.

Где размещать границы Suspense?

Там, где логично показать отдельное состояние загрузки: вокруг страницы при переходе, вокруг независимых блоков страницы. Одна граница на всё приложение показывает спиннер вместо всей страницы, что ухудшает впечатление.

Чем fallback отличается от скелетона?

Fallback — любой элемент, который Suspense показывает во время ожидания. Скелетон — популярный вид fallback: серые блоки в форме будущего содержимого, что уменьшает скачки макета.

Обучение фронтенд-разработке в OWU

Освойте фронтенд-разработку на практических курсах с менторами и реальными проектами.

Выбрать курс