Back to Nuxt

useResponseHeader

docs/4.api/2.composables/use-response-header.md

4.4.41.1 KB
Original Source

::important This composable is available in Nuxt v3.14+. ::

You can use the built-in useResponseHeader composable to set any server response header within your pages, components, and plugins.

ts
// Set a custom response header
const header = useResponseHeader('X-My-Header')
header.value = 'my-value'

Example

We can use useResponseHeader to easily set a response header on a per-page basis.

vue
<script setup>
// pages/test.vue
const header = useResponseHeader('X-My-Header')
header.value = 'my-value'
</script>

<template>
  <h1>Test page with custom header</h1>
  <p>The response from the server for this "/test" page will have a custom "X-My-Header" header.</p>
</template>

We can use useResponseHeader for example in Nuxt middleware to set a response header for all pages.

ts
export default defineNuxtRouteMiddleware((to, from) => {
  const header = useResponseHeader('X-My-Always-Header')
  header.value = `I'm Always here!`
})