Nuxt/docs/2.guide/2.directory-structure/3.error.md

1.4 KiB

title description head.title navigation.icon
error.vue The error.vue file is the error page in your Nuxt application. error.vue i-ph-file-duotone

During the lifespan of your application, some errors may appear unexpectedly at runtime. In such case, we can use the error.vue file to override the default error files and display the error nicely.

<script setup lang="ts">
const props = defineProps({
  error: Object
})
</script>

<template>
  <div>
    <h1>{{ error.statusCode }}</h1>
    <NuxtLink to="/">Go back home</NuxtLink>
  </div>
</template>

::callout Although it is called an 'error page' it's not a route and shouldn't be placed in your ~/pages directory. For the same reason, you shouldn't use definePageMeta within this page. That being said, you can still use layouts in the error file, by utilizing the NuxtLayout component and specifying the name of the layout. ::

The error page has a single prop - error which contains an error for you to handle.

The error object provides the following fields:

{
  url: string
  statusCode: number
  statusMessage: string
  message: string
  description: string
  data: any
}

If you have an error with custom fields they will be lost; you should assign them to data instead:

throw createError({
  statusCode: 404,
  statusMessage: 'Page Not Found',
  data: {
    myCustomField: true
  }
})