---
title: "useRequestHeaders"
description: "使用 useRequestHeaders 访问传入请求头。"
canonical_url: "https://nuxt.zhcndoc.com/docs/4.x/api/composables/use-request-headers"
---
# useRequestHeaders

> 使用 useRequestHeaders 访问传入请求头。

你可以使用内置的 [`useRequestHeaders`](https://nuxt.zhcndoc.com/docs/4.x/api/composables/use-request-headers) 组合式函数，在页面、组件和插件中访问传入请求头。

```ts
// 获取所有请求头
const headers = useRequestHeaders()

// 仅获取 cookie 请求头
const { cookie } = useRequestHeaders(['cookie'])
```

::tip
在浏览器中，`useRequestHeaders` 将返回一个空对象。
::

## 示例

我们可以使用 `useRequestHeaders` 在 SSR 期间访问初始请求的 `authorization` 请求头，并将其代理到之后的内部请求。

下面的示例将 `authorization` 请求头添加到一个同构的 `$fetch` 调用中。

```vue [app/pages/some-page.vue]
<script setup lang="ts">
const { data } = await useFetch('/api/confidential', {
  headers: useRequestHeaders(['authorization']),
})
</script>
```

---

- [源码](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.