Nuxt3 中文课程《实战全栈开发简书》限时优惠

createError

使用附加元数据创建一个错误对象

你可以使用这个函数来创建一个带有附加元数据的错误对象。它可在你的应用程序的Vue和Nitro部分中使用,并且意味着要被抛出。

参数

  • err: { cause, data, message, name, stack, statusCode, statusMessage, fatal }

在Vue应用中

如果你抛出一个使用createError创建的错误:

  • 在服务器端,它将触发一个全屏错误页面,你可以使用clearError来清除它。
  • 在客户端,它将抛出一个非致命错误供你处理。如果你需要触发一个全屏错误页面,你可以通过设置fatal: true来实现。

示例

pages/movies/[slug].vue
<script setup lang="ts">
const route = useRoute()
const { data } = await useFetch(`/api/movies/${route.params.slug}`)
if (!data.value) {
  throw createError({ statusCode: 404, statusMessage: '页面未找到' })
}
</script>

在API路由中

使用createError来触发服务器API路由中的错误处理。

示例

export default eventHandler(() => {
  throw createError({
    statusCode: 404,
    statusMessage: '页面未找到'
  })
})

了解更多信息,请阅读错误处理文档