v3.17
Nuxt on GitHub

<NuxtErrorBoundary>

Source
The <NuxtErrorBoundary> component handles client-side errors happening in its default slot.
The <NuxtErrorBoundary> uses Vue's onErrorCaptured hook under the hood.

Events

  • @error: Event emitted when the default slot of the component throws an error.
    <template>
  <NuxtErrorBoundary @error="logSomeError">
    <!-- ... -->
  </NuxtErrorBoundary>
</template>

Slots

  • #error: Specify a fallback content to display in case of error.
      <template>
    <NuxtErrorBoundary>
      <!-- ... -->
      <template #error="{ error, clearError }">
        <p>An error occurred: {{ error }}</p>

        <button @click="clearError">Clear error</button>
      </template>
    </NuxtErrorBoundary>
  </template>
Read more in Docs > Getting Started > Error Handling.

Examples

Accessing error and clearError in script

You can access error and clearError properties within the component's script as below:

<template>
  <NuxtErrorBoundary ref="errorBoundary">
    <!-- ... -->
  </NuxtErrorBoundary>
</template>

<script setup lang="ts">
const errorBoundary = useTemplateRef('errorBoundary')

// errorBoundary.value?.error
// errorBoundary.value?.clearError()
</script>