nuxt logo

文档翻译(非官方)

refreshNuxtData

刷新 Nuxt 中的所有或特定 asyncData 实例

refreshNuxtData 用于重新获取所有或特定的 asyncData 实例,包括来自 useAsyncDatauseLazyAsyncDatauseFetchuseLazyFetch 的实例。

如果你的组件被 <KeepAlive> 缓存并进入非激活状态,组件内的 asyncData 仍会被重新获取,直到组件被卸载。

类型

refreshNuxtData(keys?: string | string[])

参数

  • keys: 用作获取数据的单个字符串或字符串数组作为 keys。此参数是可选的。当没有明确指定 keys 时,所有 useAsyncDatauseFetch 的键都会被重新获取。

返回值

refreshNuxtData 返回一个 promise,当所有或特定的 asyncData 实例被刷新时解决。

示例

刷新所有数据

下面的示例刷新在 Nuxt 应用中使用 useAsyncDatauseFetch 获取的所有数据。

pages/some-page.vue
<script setup lang="ts">
const refreshing = ref(false)

async function refreshAll () {
  refreshing.value = true
  try {
    await refreshNuxtData()
  } finally {
    refreshing.value = false
  }
}
</script>

<template>
  <div>
    <button :disabled="refreshing" @click="refreshAll">
      Refetch All Data
    </button>
  </div>
</template>

刷新特定数据

下面的示例仅刷新键匹配 countuser 的数据。

pages/some-page.vue
<script setup lang="ts">
const refreshing = ref(false)

async function refresh () {
  refreshing.value = true
  try {
    // 你也可以传递一个键数组来刷新多个数据
    await refreshNuxtData(['count', 'user'])
  } finally {
    refreshing.value = false
  }
}
</script>

<template>
  <div v-if="refreshing">
    Loading
  </div>
  <button @click="refresh">Refresh</button>
</template>

如果你可以访问 asyncData 实例,建议使用其 refreshexecute 方法作为重新获取数据的首选方式。

另请参阅 getting-started > data-fetching