server.headers#

• Type: Record<string, string | string[]>
• Default: undefined

Adds headers to all responses sent from Rsbuild server. This configuration directly leverages Node.js response.setHeader() method under the hood.

If the header already exists in the to-be-sent headers, its value will be overwritten.

Usage#

The server.headers option accepts an object where:

• Keys are header names (case-insensitive)
• Values are either a string or an array of strings

export default {
  server: {
    headers: {
      'X-Custom-Foo': 'bar',
    },
  },
};

Multiple values#

Use an array of strings to send multiple headers with the same name.

export default {
  server: {
    headers: {
      // Multiple Set-Cookie headers
      'Set-Cookie': ['type=ninja', 'language=javascript'],
    },
  },
};