DocsAPIComposables

useRequestHeaders

Use useRequestHeaders to access the incoming request headers.

You can use built-in useRequestHeaders composable to access the incoming request headers within your pages, components, and plugins.

// Get all request headersconst headers = useRequestHeaders()// Get only cookie request headerconst headers = useRequestHeaders(['cookie'])
In the browser, useRequestHeaders will return an empty object.

Example

We can use useRequestHeaders to access and proxy the initial request's authorization header to any future internal requests during SSR.

The example below adds the authorization request header to an isomorphic $fetch call.

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