Ошибка в компоненте
На этой странице
Необработанная ошибка рендера нарушает построение дерева. Error Boundary позволяет заменить повреждённую область резервным интерфейсом.
Вопрос
Почему ошибка одного компонента может привести к исчезновению всего приложения?
Основная идея
Компонент пытается показать user.name, но user оказался null. JavaScript выбрасывает исключение до завершения рендера. React не получает корректное описание этой части интерфейса и ищет ближайшую подходящую границу ошибок среди родителей.
Если граница найдена, React переключает её на fallback. Если её нет, ошибка достигает корня и приводит к удалению дерева интерфейса этого корня. Пользователь может увидеть пустую страницу, хотя проблема находилась в маленьком виджете рекомендаций.
Границы удобно ставить вокруг самостоятельных областей: маршрута, чата, редактора или карточки аналитики. Тогда сбой рекомендаций не закрывает меню и форму поиска. Одной общей границы на корне недостаточно для хорошего UX, но она полезна как последняя защита от полного белого экрана.
Пример
Пример для клиентского React-приложения с поддержкой JSX. API в примере возвращает JSON; его адрес замените на адрес своего сервера.
import { Component } from 'react';
class ErrorBoundary extends Component {
state = { failed: false };
static getDerivedStateFromError() {
return { failed: true };
}
componentDidCatch(error, info) {
console.error(error, info.componentStack);
}
render() {
if (this.state.failed) return <p role="alert">Виджет временно недоступен</p>;
return this.props.children;
}
}
function BrokenWidget() {
throw new Error('Не удалось построить виджет');
}
export default function App() {
return <>
<header>Моя библиотека</header>
<ErrorBoundary><BrokenWidget /></ErrorBoundary>
<footer>Служба поддержки</footer>
</>;
}BrokenWidget специально выбрасывает исключение. Вместо него появляется сообщение, а шапка и подвал сохраняются. Запись в консоли ожидаема: граница локализует сбой, но не скрывает его от разработчика.
Что происходит с деревом
Без Error Boundary: С Error Boundary вокруг виджета:
<App> <App>
├─ <Header> ├─ <Header> ✓ остаётся
├─ <Recommendations> ✕ throw ├─ <ErrorBoundary>
└─ <Footer> │ └─ <Recommendations> ✕ → fallback «Недоступно»
→ весь корень размонтирован, └─ <Footer> ✓ остаётся
белый экранГде ставить границы
<RootErrorBoundary> {/* последняя линия обороны: «Что-то сломалось, обновите страницу» */}
<Header />
<Routes>
<Route
path="/dashboard"
element={
<PageErrorBoundary> {/* ошибка страницы не ломает шапку и навигацию */}
<Dashboard>
<WidgetErrorBoundary><SalesChart /></WidgetErrorBoundary> {/* независимые виджеты */}
<WidgetErrorBoundary><Reviews /></WidgetErrorBoundary>
</Dashboard>
</PageErrorBoundary>
}
/>
</Routes>
</RootErrorBoundary>Готовая граница: react-error-boundary
import { ErrorBoundary } from "react-error-boundary";
function Fallback({ error, resetErrorBoundary }) {
return (
<div role="alert">
<p>Виджет временно недоступен.</p>
<button onClick={resetErrorBoundary}>Повторить</button>
</div>
);
}
<ErrorBoundary
FallbackComponent={Fallback}
onError={(error, info) => reportError(error, info.componentStack)}
resetKeys={[userId]} // смена userId сбрасывает ошибку автоматически
>
<Recommendations userId={userId} />
</ErrorBoundary>Классовый компонент писать не нужно, есть сброс и повтор. В Next.js App Router ту же роль играют error.tsx и catchError.
Что Error Boundary НЕ ловит
| Ошибка | Чем обрабатывать |
|---|---|
В обработчике события (onClick) | try/catch в обработчике |
После await в эффекте или обработчике | try/catch, затем при необходимости showBoundary |
В setTimeout, подписках | try/catch внутри колбэка |
| В самом Error Boundary | Граница уровнем выше |
| При SSR | Серверная обработка (в Next.js — error.tsx, global-error.tsx) |
Что важно помнить
- Не используйте исключение как нормальное состояние загрузки или валидации: предусмотрите явные состояния UI.
- TypeScript уменьшает часть ошибок, но не проверяет автоматически ответ API в runtime.
- Граница не исправляет причину сбоя; для расследования нужны логи и понятный сценарий воспроизведения.
Мини-шпаргалка
Ошибка рендера → ближайшая граница → fallback. Границы нет → ошибка достигает корня.