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

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

Что такое Error Boundary в React?

Error Boundary (граница ошибок) — это компонент React, который перехватывает ошибки, возникшие во время рендера, в методах жизненного цикла или конструкторах его дочерних компонентов, и показывает запасной интерфейс вместо того, чтобы сломать всё приложение.

Без границы ошибок одна ошибка в любом компоненте приводит к тому, что React убирает весь интерфейс, и пользователь видит пустой белый экран. С границей ломается только её часть, а остальная страница продолжает работать.

Границу ошибок до сих пор создают классовым компонентом с методами static getDerivedStateFromError (переключить состояние на «ошибка») и componentDidCatch (залогировать). Чтобы не писать класс самостоятельно, часто используют библиотеку react-error-boundary с готовым компонентом и хуками.

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

Границы ошибок размещают вокруг независимых частей интерфейса: виджетов, блока отзывов, графиков, страниц в роутере, а также одну общую — на уровне всего приложения. В Next.js для этого есть специальные файлы error.js.

В componentDidCatch ошибки отправляют в сервисы мониторинга вроде Sentry, чтобы команда узнавала о проблемах в продакшене раньше, чем пользователи напишут в поддержку.

Пример

Классовая граница ошибок и её использование вокруг блока отзывов.

import { Component } from 'react';

class ErrorBoundary extends Component {
  state = { hasError: false };

  static getDerivedStateFromError() {
    return { hasError: true };
  }

  componentDidCatch(error, info) {
    logErrorToService(error, info.componentStack);
  }

  render() {
    if (this.state.hasError) {
      return this.props.fallback ?? <p>Something went wrong.</p>;
    }
    return this.props.children;
  }
}

<ErrorBoundary fallback={<p>Reviews are temporarily unavailable</p>}>
  <Reviews />
</ErrorBoundary>
getDerivedStateFromError, componentDidCatch и fallback.

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

Какие ошибки не перехватывает Error Boundary?

Ошибки в обработчиках событий, асинхронном коде (setTimeout, промисы), при серверном рендеринге и в самой границе ошибок. Их обрабатывают через try/catch и состояние компонента.

Можно ли создать Error Boundary функциональным компонентом?

Встроенного хука для этого нет, поэтому используют классовый компонент или готовую библиотеку react-error-boundary, которая прячет класс внутри.

Как дать пользователю попробовать ещё раз?

Показать в запасном интерфейсе кнопку, которая сбрасывает состояние границы ошибок и повторно рендерит дочерние компоненты. В react-error-boundary для этого есть функция resetErrorBoundary.

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

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

Выбрать курс