---
title: "useLazyAsyncData"
description: "这是对 useAsyncData 的一个封装，能够立即触发导航。"
canonical_url: "https://nuxt.zhcndoc.com/docs/3.x/api/composables/use-lazy-async-data"
---
# useLazyAsyncData

> 这是对 useAsyncData 的一个封装，能够立即触发导航。

`useLazyAsyncData` 是 [`useAsyncData`](https://nuxt.zhcndoc.com/docs/3.x/api/composables/use-async-data) 的封装，它会将 `lazy` 选项设为 `true`，从而在处理函数解析前触发导航。

::note
默认情况下，[`useAsyncData`](https://nuxt.zhcndoc.com/docs/3.x/api/composables/use-async-data) 会阻止导航，直到其异步处理函数解析完成。`useLazyAsyncData` 允许导航立即发生，同时数据获取会在后台继续进行。
::

## 用法

```vue [pages/index.vue]
<script setup lang="ts">
const { status, data: posts } = await useLazyAsyncData('posts', () => $fetch('/api/posts'))
</script>

<template>
  <div>
    <div v-if="status === 'pending'">
      加载中...
    </div>
    <div v-else-if="status === 'error'">
      加载帖子时出错
    </div>
    <div v-else>
      {{ posts }}
    </div>
  </div>
</template>
```

使用 `useLazyAsyncData` 时，导航会在数据获取完成前发生。这意味着你必须在组件模板内直接处理 `pending` 和 `error` 状态。

::warning
`useLazyAsyncData` 是一个编译器会转换的保留函数名，因此你不应将自己的函数命名为 `useLazyAsyncData`。
::

## 类型

```ts [Signature]
export function useLazyAsyncData<DataT, ErrorT> (
  handler: (ctx?: NuxtApp) => Promise<DataT>,
  options?: AsyncDataOptions<DataT>,
): AsyncData<DataT, ErrorT>

export function useLazyAsyncData<DataT, ErrorT> (
  key: string,
  handler: (ctx?: NuxtApp) => Promise<DataT>,
  options?: AsyncDataOptions<DataT>,
): AsyncData<DataT, ErrorT>
```

`useLazyAsyncData` 与 [`useAsyncData`](https://nuxt.zhcndoc.com/docs/3.x/api/composables/use-async-data) 的签名相同。

## 参数

`useLazyAsyncData` 接受与 [`useAsyncData`](https://nuxt.zhcndoc.com/docs/3.x/api/composables/use-async-data) 相同的参数，并自动将 `lazy` 选项设为 `true`。

::read-more{to="https://nuxt.zhcndoc.com/docs/3.x/api/composables/use-async-data#params"}
::

## 返回值

`useLazyAsyncData` 返回与 [`useAsyncData`](https://nuxt.zhcndoc.com/docs/3.x/api/composables/use-async-data) 相同的值。

::read-more{to="https://nuxt.zhcndoc.com/docs/3.x/api/composables/use-async-data#return-values"}
::

## 示例

```vue [pages/index.vue]
<script setup lang="ts">
/* 导航会在数据获取完成之前执行。
   请在组件的模板中直接处理 'pending' 和 'error' 状态
*/
const { status, data: count } = await useLazyAsyncData('count', () => $fetch('/api/count'))

watch(count, (newCount) => {
  // 由于 count 可能一开始为 null，无法立即访问其内容，但你可以监听它的变化。
})
</script>

<template>
  <div>
    {{ status === 'pending' ? '加载中' : count }}
  </div>
</template>
```

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

---

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


## Sitemap

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