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 снаружи ErrorBoundary | Fallback ошибки появится внутри области, пока соседи могут ещё грузиться |
Одна граница ошибок на несколько 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. Готовность → компонент. Внешние блоки продолжают работать.