useRequestHeaders

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>const { data } = await useFetch('/api/confidential', {  headers: useRequestHeaders(['authorization'])})</script>
Another example shows how we can pass cookies from the initial request to another API route.