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

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

Обрати курс