$fetch
Nuxt 使用 ofetch 全局暴露 $fetch 辅助函数,用于发出 HTTP 请求。
Nuxt 使用 ofetch 全局暴露 $fetch 辅助函数,用于在您的 Vue 应用程序或 API 路由中发出 HTTP 请求。
在服务器端渲染期间,调用
$fetch 获取内部 API 路由 将直接调用相关函数(模拟请求),节省额外的 API 调用。在不使用
useAsyncData`` 包装的情况下在组件中使用 $fetch会导致获取数据两次:最初在服务器上,然后在客户端水合期间再次获取,因为$fetch` 不会将状态从服务器传输到客户端。因此,fetch 将在两端执行,因为客户端必须再次获取数据。用法
我们建议使用 useFetch`` 或 useAsyncData`` + $fetch 来防止在获取组件数据时重复获取数据。
app/app.vue
<script setup lang="ts">
// 在 SSR 期间数据被获取两次,一次在服务器上,一次在客户端上。
const dataTwice = await $fetch('/api/item')
// 在 SSR 期间数据仅在服务器端获取并传输到客户端。
const { data } = await useAsyncData('item', () => $fetch('/api/item'))
// 您也可以使用 useFetch 作为 useAsyncData + $fetch 的快捷方式
const { data } = await useFetch('/api/item')
</script>
您可以在仅在客户端执行的任何方法中使用 $fetch。
app/pages/contact.vue
<script setup lang="ts">
async function contactForm () {
await $fetch('/api/contact', {
method: 'POST',
body: { hello: 'world' },
})
}
</script>
<template>
<button @click="contactForm">
Contact
</button>
</template>
如果您使用
$fetch 在开发中调用带有自签名证书的(外部)HTTPS URL,您需要在环境中设置 NODE_TLS_REJECT_UNAUTHORIZED=0。传递标头和 Cookie
当我们在浏览器中调用 $fetch 时,像 cookie 这样的用户标头将直接发送到 API。
但是,在服务器端渲染期间,由于安全风险,如服务器端请求伪造 (SSRF) 或身份验证滥用,$fetch 不会包含用户的浏览器 cookie,也不会传递来自 fetch 响应的 cookie。
<script setup lang="ts">
// 这在 SSR 期间不会转发标头或 cookie
const { data } = await useAsyncData(() => $fetch('/api/cookies'))
</script>
export default defineEventHandler((event) => {
const foo = getCookie(event, 'foo')
// ... 使用 cookie 做一些事情
})
如果您需要在服务器上转发标头和 cookie,您必须手动传递它们:
app/pages/index.vue
<script setup lang="ts">
// 这会将用户的标头和 cookie 转发到 `/api/cookies`
const requestFetch = useRequestFetch()
const { data } = await useAsyncData(() => requestFetch('/api/cookies'))
</script>
但是,当在服务器上使用相对 URL 调用 useFetch 时,Nuxt 将使用 useRequestFetch`` 代理标头和 cookie(不包括不应转发的标头,如 host`)。