# nuxt-errors

> Error handling with error classes, handlers, and interceptors. Use when handling API errors, displaying validation errors, configuring error handlers, or implementing error interceptors.

- Author: github-actions[bot]
- Repository: leeovery/claude-nuxt
- Version: 20260120162103
- Stars: 2
- Forks: 0
- Last Updated: 2026-02-06
- Source: https://github.com/leeovery/claude-nuxt
- Web: https://mule.run/skillshub/@@leeovery/claude-nuxt~nuxt-errors:20260120162103

---

---
name: nuxt-errors
description: Error handling with error classes, handlers, and interceptors. Use when handling API errors, displaying validation errors, configuring error handlers, or implementing error interceptors.
---

# Nuxt Error Handling

Centralized error handling with typed error classes and configurable handlers.

## Core Concepts

**[errors.md](references/errors.md)** - Error classes, handlers, interceptors

## Error Classes

```typescript
import { ValidationError } from '#layers/base/app/errors/validation-error'
import { ConflictError } from '#layers/base/app/errors/conflict-error'
import { TooManyRequestsError } from '#layers/base/app/errors/too-many-requests-error'

// ValidationError (422)
if (error instanceof ValidationError) {
  error.errors    // Record<string, string[]>
  error.message   // string
  error.mapToFormErrors()  // FormError[]
}
```

## Error Handlers Configuration

```typescript
// app.config.ts
export default defineAppConfig({
  errorHandlers: {
    401: async ({ flash }) => navigateTo('/auth/login'),
    422: async ({ response }) => Promise.reject(new ValidationError(response)),
    500: async ({ flash }) => flash.error('Server error'),
  },
})
```

## Action Error Handling

```typescript
const { handleActionError } = useHandleActionError()

try {
  await createPost(data)
} catch (error) {
  throw handleActionError(error, {
    entity: 'post',
    operation: 'create',
  })
}
// Shows: "Failed to create post. [error details]"
```