К основному содержанию
скилл CX Codex

react-error-handling — скилл для Claude Code: установка и обзор

Скилл react-error-handling помогает проектировать предохранители и запасные интерфейсы в React, чтобы сбой в дочернем компоненте не ломал всё приложение.

MIT 134 установок ★ 29 обновлён 2026-08-17

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add oakoss/agent-skills --skill react-error-handling -a claude-code
Открыть на GitHub

Что делает react-error-handling

Скилл содержит правила изоляции ошибок рендеринга через классовые компоненты или библиотеку react-error-boundary. Он подсказывает, как настроить автоматический сброс состояния через resetKeys, изолировать отдельные блоки дерева и логировать стек вызовов через onError.

Предохранители не перехватывают ошибки внутри обработчиков событий, таймеров и асинхронных колбэков вне Suspense. Для кликов или сетевых запросов нужно использовать стандартный try/catch. Если в проекте настроен TanStack Router, обработку ошибок на уровне маршрутов скилл советует делегировать правилу tanstack-router.

Какие задачи решает

  • настроить запасной интерфейс с кнопкой повторной попытки через react-error-boundary
  • изолировать сбои в виджетах, чтобы не падала вся страница
  • написать классовый предохранитель с методами getDerivedStateFromError и componentDidCatch
  • организовать передачу пойманных ошибок рендеринга в систему мониторинга

Примеры запросов агенту

  • Оберни блок с графиком в предохранитель из библиотеки react-error-boundary с кнопкой повтора
  • Напиши классовый ErrorBoundary с логированием ошибок через onError и чистым методом getDerivedStateFromError
  • Покажи, как сбрасывать состояние ошибки в FallbackComponent при смене props через resetKeys

Как установить react-error-handling

1Через Skills CLI (Vercel)

npx skills add oakoss/agent-skills --skill react-error-handling -a claude-code

2Вручную: положить файлы

~/.claude/skills/react-error-handling/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/react-error-handling/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о react-error-handling

Как установить react-error-handling в Claude Code?

Выполните в терминале команду npx skills add oakoss/agent-skills --skill react-error-handling -a claude-code.

Что делает этот скилл?

Он задаёт шаблоны создания React Error Boundary, учит настраивать запасной интерфейс, кнопки повтора и предотвращать падение всего дерева компонентов.

Перехватывает ли предохранитель ошибки в обработчиках кликов?

Нет. Границы ошибок React работают только во время рендеринга и в методах жизненного цикла, а для событий и асинхронных функций нужен обычный try/catch.

Исходный текст

SKILL.md · MIT
---
name: react-error-handling
description: 'React error boundaries and fallback UIs for catching rendering errors. Use when handling component crashes, displaying error states, implementing error recovery, or preventing full-page crashes. Use for ErrorBoundary, componentDidCatch, getDerivedStateFromError, error fallback, error recovery, crash handling, react-error-boundary library.'
license: MIT
metadata:
  author: oakoss
  version: '1.0'
  source: 'https://react.dev/reference/react/Component#catching-rendering-errors-with-an-error-boundary'
user-invocable: false
---

# React Error Handling

## Overview

Error boundaries catch JavaScript errors during rendering, in lifecycle methods, and in constructors of child components. They display fallback UIs instead of crashing the entire component tree. Error boundaries can only be implemented as class components in vanilla React, but the `react-error-boundary` library provides a convenient function component wrapper.

**When to use:** Component crashes, preventing error propagation to parent routes, graceful degradation, user-facing error states, error logging and monitoring.

**When NOT to use:** Event handler errors (use try/catch), async callbacks outside rendering (setTimeout, promises without Suspense), server-side rendering errors, errors in the boundary itself.

## Quick Reference

| Pattern               | API                                                        | Key Points                                 |
| --------------------- | ---------------------------------------------------------- | ------------------------------------------ |
| Class boundary        | `getDerivedStateFromError` + `componentDidCatch`           | Manual implementation, full control        |
| Function boundary     | `<ErrorBoundary FallbackComponent={...} />`                | Uses react-error-boundary library          |
| Reset mechanism       | `resetErrorBoundary()` or `resetKeys={[dep]}`              | Auto-reset on state change or manual retry |
| Error logging         | `onError={(error, info) => log(error)}`                    | Log to analytics or monitoring service     |
| Fallback component    | `FallbackComponent={MyFallback}`                           | Receives error and resetErrorBoundary      |
| Inline fallback       | `fallback={<div>Error occurred</div>}`                     | Static JSX, no error details               |
| Render prop fallback  | `fallbackRender={({ error, reset }) => <UI />}`            | Dynamic fallback with error access         |
| Nested boundaries     | Wrap at multiple tree levels                               | Granular error isolation                   |
| Route-level boundary  | TanStack Router `errorComponent`                           | Delegate to tanstack-router skill          |
| Suspense integration  | Wrap Suspense boundaries for async errors                  | Catch errors thrown by Suspense            |
| Event handler errors  | `try/catch` in handler, not error boundary                 | Boundaries don't catch event errors        |
| useErrorBoundary hook | `const { showBoundary, resetBoundary } = useErrorBoundary` | Manually trigger boundary from child       |

## Common Mistakes

| Mistake                          | Correct Pattern                                         |
| -------------------------------- | ------------------------------------------------------- |
| Using error boundary for events  | Use try/catch in event handlers                         |
| Wrapping every single component  | Place boundaries at meaningful UI sections              |
| Not providing reset mechanism    | Include retry button or resetKeys                       |
| Showing stack traces in prod     | Only render stack in development mode                   |
| Missing onError for logging      | Always log errors to monitoring service                 |
| Catching errors in boundary self | Error boundaries only catch child component errors      |
| Using async code in getDerived   | getDerivedStateFromError must be pure, use didCatch     |
| Relying on componentDidCatch     | Use getDerivedStateFromError for state updates          |
| Not testing error boundaries     | Test with error-throwing components                     |
| Ignoring resetKeys pattern       | Use resetKeys for automatic recovery on state change    |
| Blocking Suspense fallbacks      | Error boundaries around Suspense should allow fallbacks |

## Delegation

> If the `tanstack-router` skill is available, delegate route-level error handling (errorComponent, notFoundComponent, loader errors) to it. Otherwise, recommend: `npx skills add oakoss/agent-skills --skill tanstack-router`

- **Error monitoring setup**: Delegate to integration/observability specialists
- **Complex recovery flows**: Use `Task` agent for multi-step error recovery patterns
- **Error boundary testing**: Delegate test writing to testing specialists

## References

- [Class-based error boundaries](references/class-boundaries.md)
- [react-error-boundary library](references/react-error-boundary.md)
- [Fallback UI patterns](references/fallback-patterns.md)
- [Reset and recovery patterns](references/reset-recovery.md)
- [Error boundary placement strategies](references/boundary-placement.md)

© oakoss · MIT · oakoss/agent-skills

Похожие скиллы

Все скиллы по теме «Фронтенд и UI» →
error-handling-recovery zebbern Правило error-handling-recovery для Claude Code обрабатывает потерю WebGL-контекста, пересоздаёт ресурсы и показывает запасной интерфейс в Three.js-сценах. CX Codex +1 ★ 4 719звёзд репо react-patterns manutej Скилл react-patterns для Claude Code учит агента современным паттернам React: хукам, композиции компонентов и управлению состоянием. Охватывает React 18+, Server Components и мемоизацию. CX Codex +1 474установок correctness-and-error-handling cognitedata Скилл correctness-and-error-handling находит и устраняет сбои в React-коде Cognite Flows: монтирует Error Boundary, обрабатывает промисы и закрывает пустые состояния интерфейса. CX Codex +1 1 900установок react-useeffect davila7 Скилл react-useeffect разбирает правила работы с useEffect по официальной документации React и подсказывает, чем заменить Effect там, где он лишний. CX Codex +1 127установок react-server-components patterns.dev Скилл объясняет React Server Components: какие компоненты рендерить на сервере и где ставить 'use client'. Пригодится в Next.js App Router. CX Codex +1 1 000установок langgraph-error-handling soba-labs Скилл langgraph-error-handling для Claude Code помогает настраивать обработку ошибок в LangGraph. Подключается, когда нужно добавить повторы, восстановление через LLM или передачу решения человеку. CX Codex +1 ★ 106звёзд репо

Из того же набора106

Весь набор →
vite Описывает конфиг Vite, плагины, dev-сервер, сборку, SSR и переменные окружения. Задачи: правка vite.config.ts и сборка библиотек. CX Codex +1 138установок postgres-tuning Скилл postgres-tuning для Claude Code, Codex, Cursor и других агентов, который даёт инструкции по настройке производительности PostgreSQL 17/18+. Охватывает async I/O, анализ планов запросов, индексы, autovacuum, pgvector и PgBouncer. CX Codex +1 136установок tanstack-db Помогает проектировать реактивное клиентское хранилище на TanStack DB: живые запросы, связи коллекций и оптимистичные изменения. Описывает локальные данные и синхронизацию. CX Codex +1 136установок prompt-engineering Скилл prompt-engineering для Claude Code собирает приёмы проектирования промптов: цепочки рассуждений, ReAct-циклы, шаблоны системных промптов, extended thinking и сжатие контекста. CX Codex +1 135установок frontend-builder Скилл frontend-builder помогает спроектировать и собрать интерфейс на React или Next.js: от компонентов и состояния до форм, стилей и обработки ошибок. Пригодится при создании веб-приложения или выборе архитектуры. CX Codex +1 134установок mise Обучает агента работать с mise — менеджером версий инструментов, переменных окружения и задач. CX Codex +1 133установок data-visualizer Скилл data-visualizer помогает строить графики и дашборды на Recharts, Chart.js или D3.js с учётом адаптивности и доступности. CX Codex +1 133установок knowledge-base-manager Скилл knowledge-base-manager для Claude Code помогает выбрать архитектуру базы знаний и выстроить её поддержку. Охватывает отбор контента, контроль качества и версионирование. CX Codex +1 131установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой