Skip to content

Error Boundary Kit

Готовые к продакшену границы ошибок для Vue 3 — декларативный компонент, composable для программного использования и слой отчётности на основе адаптеров.

Декларативный компонент ErrorBoundary

Оборачивайте любую часть приложения в <ErrorBoundary> с fallback-слотом для отображения ошибки. Управляйте состоянием через resetKeys, maxRetries, автоматический сброс при изменении пропсов. Получайте доступ к ошибке, методам reset/retry и счётчику попыток как в слоте, так и через ref.

Программный перехват и глобальный мониторинг

Используйте useErrorBoundary() для ручной регистрации ошибок из любого кода — например, при парсинге JSON или в обработчиках событий. А с помощью useGlobalErrorCapture() перехватывайте необработанные ошибки и отклонённые промисы, которые Vue не видит.

Гибкая система репортинга с адаптерами

Отправляйте ошибки в Sentry, Bugsnag, LogRocket, HTTP endpoint или консоль через подключаемые адаптеры. Каждый адаптер поставляется отдельным entry point, не раздувая основной бандл. Встроенные rate-limiting и breadcrumbs защищают от спама и дают контекст.

Готовая интеграция с Nuxt, vue-router и TanStack Query

Nuxt-модуль автоматически регистрирует компонент и утилиты. useNuxtErrorBoundary() перехватывает ошибки на уровне приложения, а useRouterErrorBoundary() — ошибки навигации и асинхронных роутов. Для TanStack Query есть хук сброса ошибочных запросов.

AsyncBoundary, история ошибок и SSR-безопасность

AsyncBoundary объединяет Suspense и ErrorBoundary с единым API и слотами loading/fallback. Для отладки используйте историю ошибок и панель в devtools. Все компоненты безопасны для SSR — ошибки рендеринга не роняют сервер, а гидратация всегда сходится к корректному состоянию.