---
title: "useRequestFetch"
description: "使用 useRequestFetch 组合函数在服务器端进行 fetch 请求时转发请求上下文和头信息。"
canonical_url: "https://nuxt.zhcndoc.com/docs/3.x/api/composables/use-request-fetch"
---
# useRequestFetch

> 使用 useRequestFetch 组合函数在服务器端进行 fetch 请求时转发请求上下文和头信息。

你可以使用 `useRequestFetch` 在服务器端进行 fetch 请求时转发请求上下文和头信息。

在进行客户端 fetch 请求时，浏览器会自动发送必要的头信息。
但是，在服务器端渲染期间发起请求时，出于安全考虑，我们需要手动转发头信息。

::note
**不应转发的**头信息**不会包含**在请求中。这些头信息例如包括：
`transfer-encoding`、`connection`、`keep-alive`、`upgrade`、`expect`、`host`、`accept`
::

::tip
[`useFetch`](https://nuxt.zhcndoc.com/docs/3.x/api/composables/use-fetch) 组合函数在内部使用 `useRequestFetch`，以自动转发请求上下文和头信息。
::

::code-group
```vue [pages/index.vue]
<script setup lang="ts">
// 这会将用户的头信息转发到 `/api/cookies` 事件处理器
// 结果：{ cookies: { foo: 'bar' } }
const requestFetch = useRequestFetch()
const { data: forwarded } = await useAsyncData(() => requestFetch('/api/cookies'))

// 这不会转发任何信息
// 结果：{ cookies: {} }
const { data: notForwarded } = await useAsyncData((_nuxtApp, { signal }) => $fetch('/api/cookies', { signal }))
</script>
```

```ts [server/api/cookies.ts]
export default defineEventHandler((event) => {
  const cookies = parseCookies(event)

  return { cookies }
})
```
::

::tip
在浏览器中进行客户端导航时，`useRequestFetch` 的行为与常规 [`$fetch`](https://nuxt.zhcndoc.com/docs/3.x/api/utils/dollarfetch) 一样。
::

---

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


## Sitemap

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