re:re:actable
Урок 063 минуты чтения

Error Boundary и Suspense

На этой странице
Кратко

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

Вопрос

Как совместить ожидание загрузки и обработку ошибки lazy-компонента?

Основная идея

Для асинхронного блока есть как минимум три исхода: ресурс ещё ожидается, ресурс готов и ресурс получить не удалось. У Suspense и Error Boundary разные задачи. Первая граница показывает fallback ожидания, вторая — резервный UI ошибки.

При lazy React ожидает динамический импорт модуля. Пока Promise импорта не завершён, срабатывает Suspense. Если импорт отклонён, например JS-файл недоступен после деплоя, ошибка попадёт в Error Boundary. У обычного запроса из эффекта такой интеграции нет: ожидание и ошибка остаются состоянием компонента.

Часто Error Boundary размещают снаружи Suspense, чтобы защитить весь блок, включая его fallback. Это удобная композиция, а не единственная законная вложенность. Можно иметь одну границу ошибки вокруг нескольких независимых Suspense-блоков или несколько локальных границ по смысловым областям.

Пример

Клиентский проект с динамическими импортами и установленным пакетом react-error-boundary; пример состоит из двух файлов.

App.jsx

import { lazy, Suspense } from 'react';
import { ErrorBoundary } from 'react-error-boundary';
 
const Recommendations = lazy(() => import('./Recommendations.jsx'));
export default function App() {
  return <>
    <h1>Каталог книг</h1>
    <ErrorBoundary fallback={<p role="alert">Рекомендации недоступны</p>}>
      <Suspense fallback={<p role="status">Подбираем рекомендации...</p>}>
        <Recommendations />
      </Suspense>
    </ErrorBoundary>
  </>;
}

Recommendations.jsx

export default function Recommendations() {
  return <p>Вам может понравиться «React без паники»</p>;
}

Заголовок появляется независимо от загрузки модуля. Успех открывает рекомендации, а ошибка импорта показывает сообщение только для этого блока.

Три исхода одного блока

<ErrorBoundary fallback={«Не удалось»}>
  <Suspense fallback={«Загрузка…»}>
    <Comments />            ← use(promise) или lazy-компонент
  </Suspense>
</ErrorBoundary>
 
промис ещё ждёт      → Suspense показывает «Загрузка…»
промис выполнен      → <Comments /> с данными
промис отклонён      → ошибка «всплывает» → ErrorBoundary показывает «Не удалось»

С данными: use + Suspense + Error Boundary (React 19)

import { Suspense, use } from "react";
import { ErrorBoundary } from "react-error-boundary";
 
function Comments({ commentsPromise }) {
  const comments = use(commentsPromise); // ждёт → Suspense; отклонён → ErrorBoundary
  return <ul>{comments.map((c) => <li key={c.id}>{c.text}</li>)}</ul>;
}
 
export function Post({ commentsPromise }) {
  return (
    <ErrorBoundary fallback={<p role="alert">Комментарии недоступны</p>}>
      <Suspense fallback={<p role="status">Загружаем комментарии…</p>}>
        <Comments commentsPromise={commentsPromise} />
      </Suspense>
    </ErrorBoundary>
  );
}

Порядок вложенности

ВариантЧто происходит
ErrorBoundary снаружи Suspense (рекомендуемо)Ошибка заменяет весь блок, включая индикатор загрузки
Suspense снаружи ErrorBoundaryFallback ошибки появится внутри области, пока соседи могут ещё грузиться
Одна граница ошибок на несколько SuspenseОшибка любого из них скрывает всю группу

Ошибка загрузки чанка после деплоя

function ChunkErrorFallback({ error }) {
  const isChunkError = /Loading chunk|Failed to fetch dynamically imported module/i.test(error.message);
  return (
    <div role="alert">
      <p>{isChunkError ? "Вышла новая версия приложения." : "Блок недоступен."}</p>
      <button onClick={() => window.location.reload()}>Обновить страницу</button>
    </div>
  );
}

lazy кэширует отклонённый импорт, поэтому resetErrorBoundary не поможет — нужна перезагрузка страницы (или своя обёртка над import() с повтором).

Что важно помнить

  • Пример требует react-error-boundary и двух отдельных модулей.
  • Сброс Error Boundary не обязательно повторяет кешированный lazy-импорт: для ошибки чанка часто нужна перезагрузка или отдельная стратегия восстановления.
  • Не пишите собственный протокол «бросать Promise» ради учебного fetch; используйте поддерживаемый источник.

Мини-шпаргалка

Ожидание → Suspense. Ошибка → Error Boundary. Готовность → компонент. Внешние блоки продолжают работать.

Документация

Suspense. Перехват ошибок через Error Boundary.

Дочитали до конца?
Отметьте урок — прогресс сохранится в браузере.

Поиск

Поиск по урокам