37% OFF during Black Friday at Mastering Nuxt.

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 headers
const headers = useRequestHeaders()

// Get only cookie request header
const 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>