Nuxt 3 已于 31 July 2026 结束生命周期
此版本将不再接收错误修复或安全补丁。 升级到 Nuxt 4 或获取 HeroDevs 提供的延长支持

useError

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

Maschinelle Übersetzung ·0 % geprüft

用法

useError 组合式函数返回正在处理的全局 Nuxt 错误，并在客户端和服务器上均可用。它在您的应用程序中提供了一个响应式、支持 SSR 的错误状态。

const error = useError()

您可以在您的组件、页面或插件中使用此可组合项，以访问或响应当前的 Nuxt 错误。

类型

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

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

参数

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

返回值

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

示例

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

if (error.value) {
  console.error('Nuxt 错误:', error.value)
}
</script>
Weitere Informationen findest du unter Docs > Getting Started > Error Handling.