v4 (4.0.0)
Nuxt on GitHub

useError

源代码
useError 可组合函数返回正在处理的全局 Nuxt 错误。

使用方法

useError 可组合函数返回正在处理的全局 Nuxt 错误，在客户端和服务器端均可用。它提供了跨应用的响应式、SSR 友好的错误状态。

const error = useError()

你可以在组件、页面或插件中使用此可组合函数来访问或响应当前的 Nuxt 错误。

类型

interface NuxtError<DataT = unknown> {
  statusCode: number
  statusMessage: string
  message: string
  data?: DataT
  error?: true
}

export const useError: () => Ref<NuxtError | undefined>

参数

此可组合函数不接受任何参数。

返回值

返回一个包含当前 Nuxt 错误的 Ref（如果没有错误，则为 undefined）。错误对象是响应式的，当错误状态发生变化时会自动更新。

示例

<script setup lang="ts">
const error = useError()

if (error.value) {
  console.error('Nuxt 错误：', error.value)
}
</script>
阅读更多 Docs > Getting Started > Error Handling.