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

Типы ошибок в React-приложении

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

Обработка ошибки зависит от места возникновения: рендер, синхронный эффект, событие, асинхронное продолжение или сервер.

Вопрос

Какие ошибки возникают в React и как выбрать подходящий способ обработки?

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

Не всякая ошибка в React-приложении является ошибкой React-рендера. Неуспешный пароль — ожидаемый ответ бизнес-логики. TypeError при чтении поля null — дефект построения UI. Сетевой тайм-аут — проблема внешней операции. Если всё отправлять в один fallback, пользователь потеряет возможность исправить ввод или повторить запрос.

Error Boundary локализует ошибки React-поддерева: рендера, конструкторов и жизненного цикла, включая синхронные ошибки запуска эффектов. Обычный обработчик onClick выполняется отдельно и требует локальной обработки. Отклонённый Promise нужно обрабатывать через await с try/catch или .catch().

Ошибки сборки и TypeScript возникают до запуска приложения, а ошибки SSR — на сервере. Их нельзя исправить клиентской границей. Глобальный мониторинг помогает обнаружить пропущенные проблемы, но не заменяет корректную обработку в месте, где известен контекст операции.

Карта ошибок

                         Где возникла ошибка?
     ┌──────────────┬───────────────┼─────────────────┬──────────────────┐
  До запуска     Рендер /       Обработчик /        Ожидаемая         Сервер
  (сборка, TS)   эффект         async-код           (бизнес-логика)   (SSR, API)
     │              │               │                    │                 │
  CI, линтер,   Error Boundary   try/catch +          Состояние         Логи, error.tsx,
  типы          (fallback UI)    сообщение у          формы/поля        статус-коды
                                 действия
ТипПримерОжидаемая?Что увидит пользователь
Валидация«Пароль короче 8 символов»ДаТекст у поля
Бизнес-отказ«Товара нет в наличии»ДаСообщение у действия
Авторизация401/403ДаРедирект на вход / «Нет доступа»
СетьТаймаут, офлайнВременная«Нет соединения» + повтор
Сервер500Нет«Сервис недоступен» + повтор
Дефект кодаCannot read properties of nullНетFallback Error Boundary + отчёт в мониторинг

Пример

Пример для клиентского React-приложения с поддержкой JSX. API в примере возвращает JSON; его адрес замените на адрес своего сервера.

import { useState } from 'react';
 
export default function SaveButton() {
  const [message, setMessage] = useState('');
  const [pending, setPending] = useState(false);
  async function save() {
    setPending(true);
    try {
      const response = await fetch('/api/draft', { method: 'PUT' });
      if (!response.ok) throw new Error(`HTTP ${response.status}`);
      setMessage('Черновик сохранён');
    } catch {
      setMessage('Не удалось сохранить. Попробуйте ещё раз.');
    } finally { setPending(false); }
  }
  return <>
    <button onClick={save} disabled={pending}>Сохранить</button>
    <p role="status">{message}</p>
  </>;
}

Ошибка запроса превращается в сообщение рядом с действием. Остальная страница продолжает работать; пользователю не приходится закрывать редактор из-за временного сбоя сети.

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

  • fetch на 500 не отклоняет Promise автоматически.
  • React 19 Actions интегрируются с границами ошибок, но это не делает любой async onClick автоматически защищённым.
  • Валидация, авторизация и инфраструктурная ошибка требуют разных текстов и дальнейших действий.

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

Где ошибкаЧто использовать
Рендер/React lifecycleError Boundary
Событие/обычный Promisetry/catch, catch
SSR/сборкаСерверная обработка, диагностика сборки
Ожидаемая валидацияОшибка поля или формы

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

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

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

Поиск

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