message.headers

版本历史

版本	变更
v18.14.0	`http.request()` 和 `http.createServer()` 函数中的 `joinDuplicateHeaders` 选项确保不会丢弃重复的标头，而是根据 RFC 9110 第 5.3 节使用逗号分隔符组合。
v15.1.0	`message.headers` 现在使用原型上的访问器属性延迟计算，不再可枚举。
v0.1.5	新增于: v0.1.5

请求/响应头对象。

标头名称和值的键值对。标头名称是小写的。

// 打印如下内容：
//
// { 'user-agent': 'curl/7.22.0',
//   host: '127.0.0.1:8000',
//   accept: '*/*' }
console.log(request.headers);

原始标头中的重复项按以下方式处理，具体取决于标头名称：

重复的 age、authorization、content-length、content-type、etag、expires、from、host、if-modified-since、if-unmodified-since、last-modified、location、max-forwards、proxy-authorization、referer、retry-after、server 或 user-agent 被丢弃。要允许合并上面列出的标头的重复值，请在 http.request() 和 http.createServer() 中使用选项 joinDuplicateHeaders。有关详细信息，请参阅 RFC 9110 第 5.3 节。
set-cookie 始终是数组。重复项被添加到数组中。
对于重复的 cookie 标头，值使用 ; 连接。
对于所有其他标头，值使用 , 连接。

History

Version	Changes
v18.14.0	The `joinDuplicateHeaders` option in the `http.request()` and `http.createServer()` functions ensures that duplicate headers are not discarded, but rather combined using a comma separator, in accordance with RFC 9110 Section 5.3.
v15.1.0	`message.headers` is now lazily computed using an accessor property on the prototype and is no longer enumerable.
v0.1.5	Added in: v0.1.5

The request/response headers object.

Key-value pairs of header names and values. Header names are lower-cased.

// Prints something like:
//
// { 'user-agent': 'curl/7.22.0',
//   host: '127.0.0.1:8000',
//   accept: '*/*' }
console.log(request.headers);

Duplicates in raw headers are handled in the following ways, depending on the header name:

Duplicates of age, authorization, content-length, content-type, etag, expires, from, host, if-modified-since, if-unmodified-since, last-modified, location, max-forwards, proxy-authorization, referer, retry-after, server, or user-agent are discarded. To allow duplicate values of the headers listed above to be joined, use the option joinDuplicateHeaders in http.request() and http.createServer(). See RFC 9110 Section 5.3 for more information.
set-cookie is always an array. Duplicates are added to the array.
For duplicate cookie headers, the values are joined together with ; .
For all other headers, the values are joined together with , .