useLazyAsyncData

源文件
这是 useAsyncData 的一个包装器，会立即触发导航。

useLazyAsyncData 提供了一个 useAsyncData 的包装器，通过将 lazy 选项设置为 true，使其在处理程序解析之前触发导航。

默认情况下，useAsyncData 会阻塞导航，直到其异步处理程序解析完成。useLazyAsyncData 允许立即进行导航，同时在后台继续获取数据。

使用

app/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'">
      Loading...
    </div>
    <div v-else-if="status === 'error'">
      Error loading posts
    </div>
    <div v-else>
      {{ posts }}
    </div>
  </div>
</template>

当使用 useLazyAsyncData 时，导航会在数据获取完成前发生。这意味着你必须在组件模板中直接处理 pending（挂起）和 error（错误）状态。

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

类型

签名
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 相同的签名。

参数

useLazyAsyncData 接受与 useAsyncData 相同的参数，并将 lazy 选项自动设置为 true。

阅读更多内容请见 Docs > 4 X > API > Composables > Use Async Data#parameters。

返回值

useLazyAsyncData 返回与 useAsyncData 相同的值。

阅读更多内容请见 Docs > 4 X > API > Composables > Use Async Data#return Values。

示例

app/pages/index.vue
<script setup lang="ts">
/* Navigation will occur before fetching is complete.
  Handle 'pending' and 'error' states directly within your component's template
*/
const { status, data: count } = await useLazyAsyncData('count', () => $fetch('/api/count'))

watch(count, (newCount) => {
  // Because count might start out null, you won't have access
  // to its contents immediately, but you can watch it.
})
</script>

<template>
  <div>
    {{ status === 'pending' ? 'Loading' : count }}
  </div>
</template>
在文档 > 4 X > 入门 > 数据获取中阅读更多信息。