---
title: "useError"
description: "useError 组合函数返回正在处理的全局 Nuxt 错误。"
canonical_url: "https://nuxt.zhcndoc.com/docs/3.x/api/composables/use-error"
---
# useError

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

## 用法

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

```ts
const error = useError()
```

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

## 类型

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

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

## 参数

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

## 返回值

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

## 示例

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

if (error.value) {
  console.error('Nuxt 错误:', error.value)
}
</script>
```

::read-more{to="https://nuxt.zhcndoc.com/docs/3.x/getting-started/error-handling"}
::

---

- [源码](https://github.com/nuxt/nuxt/blob/main/packages/nuxt/src/app/composables/error.ts)


## Sitemap

See the full [sitemap](https://nuxt.zhcndoc.com/sitemap.md) for all pages.