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

Логирование ошибок

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

Логи связывают пользовательский сбой с технической причиной: стеком, версией приложения, маршрутом и контекстом операции.

Вопрос

Что логировать в React-приложении и как не потерять ошибки за пределами Error Boundary?

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

Пользователь пишет «не открывается карточка», но у разработчика всё работает. Для расследования нужны сведения о конкретном сбое: какая версия была загружена, в каком блоке произошла ошибка, какой запрос завершился неуспешно. Одного текста Something went wrong для этого недостаточно.

Для ошибки React-поддерева componentDidCatch предоставляет componentStack, дополняющий обычный JavaScript stack. Для API-ошибок полезны безопасное имя операции, HTTP-статус и request ID. Sourcemaps помогают сопоставить минифицированный стек с исходниками; их публикацию и доступ настраивают осознанно.

Граница не охватывает все источники. SDK мониторинга обычно дополняет её обработкой глобальных error, unhandledrejection и серверными интеграциями. При этом не нужно бездумно отправлять всё подряд: персональные данные, токены и содержимое форм могут оказаться в URL, заголовках и сообщениях ошибок.

Пример

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

import { Component } from 'react';
 
function reportError(error, info) {
  const event = {
    message: error instanceof Error ? error.message : 'Неизвестная ошибка',
    componentStack: info.componentStack,
    release: 'training-1',
    area: 'recommendations',
  };
  console.error('Событие мониторинга', event);
  // В реальном приложении здесь вызов настроенного SDK с фильтрацией данных.
}
class ErrorBoundary extends Component {
  state = { failed: false };
  static getDerivedStateFromError() { return { failed: true }; }
  componentDidCatch(error, info) { reportError(error, info); }
  render() {
    return this.state.failed ? <p role="alert">Блок недоступен</p>
      : this.props.children;
  }
}
function Widget() { throw new Error('Некорректный формат рекомендации'); }
export default function App() {
  return <ErrorBoundary><Widget /></ErrorBoundary>;
}

Пример показывает структуру события в консоли. Он не отправляет данные наружу и не является готовой настройкой мониторинга; SDK добавляют отдельно.

Откуда приходят ошибки и кто их ловит

Ошибка рендера в поддереве с Error Boundary  → componentDidCatch / onCaughtError
Ошибка рендера без Error Boundary            → onUncaughtError (React 19), корень размонтирован
Восстановимые ошибки (гидратация)            → onRecoverableError
throw в обработчике, setTimeout              → window "error"
Отклонённый промис без catch                 → window "unhandledrejection"
Ошибки API                                   → свой http-клиент (статус, request id)

Подключение на уровне корня (React 19)

import { createRoot } from "react-dom/client";
 
const root = createRoot(document.getElementById("root"), {
  onCaughtError(error, info) {
    report(error, { componentStack: info.componentStack, handled: true });
  },
  onUncaughtError(error, info) {
    report(error, { componentStack: info.componentStack, handled: false });
  },
  onRecoverableError(error, info) {
    report(error, { level: "warning" });
  },
});
root.render(<App />);
 
window.addEventListener("unhandledrejection", (e) => report(e.reason, { source: "promise" }));

С сервисом мониторинга (на примере Sentry)

import * as Sentry from "@sentry/react";
 
Sentry.init({
  dsn: import.meta.env.VITE_SENTRY_DSN,
  release: import.meta.env.VITE_RELEASE,  // связать ошибку с версией
  environment: import.meta.env.MODE,
  sendDefaultPii: false,                  // не отправлять персональные данные
  beforeSend(event) {
    delete event.request?.cookies;        // дополнительная фильтрация
    return event;
  },
});
 
const root = createRoot(container, {
  onUncaughtError: Sentry.reactErrorHandler(),
  onCaughtError: Sentry.reactErrorHandler(),
  onRecoverableError: Sentry.reactErrorHandler(),
});

Что включать в событие

ПолеЗачем
message, stack (+ source maps)Где упало в исходниках
componentStackВ каком компоненте
release, environmentСвязь с деплоем, регрессии
Маршрут, действие пользователя (breadcrumbs)Как воспроизвести
HTTP-статус, request idСвязать с логами бэкенда
Браузер, ОСПроблемы конкретных платформ
✗ Токены, пароли, содержимое форм, emailНельзя — утечка данных

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

  • Сбой отправки лога не должен вызывать новую цепочку аварий.
  • Группируйте дубликаты, учитывайте версию релиза и частоту затронутых пользователей.
  • Для обработанных и необработанных ошибок React 19 доступны также соответствующие callbacks корня; избегайте двойной отправки одного события.

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

Ошибка + stack + componentStack + release + безопасный контекст. Пользователю → понятное сообщение, разработчику → диагностика.

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

Перехват ошибок через Error Boundary. Обработка ошибок корня.

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

Поиск

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