标头对象
标头在 JavaScript 对象上表示为自身的属性。
属性键将被序列化为小写。
属性值应该是字符串(如果不是,它们将被强制转换为字符串)或 Array 个字符串(以便为每个标头字段发送一个以上的值)。
const headers = {
':status': '200',
'content-type': 'text-plain',
'ABC': ['has', 'more', 'than', 'one', 'value'],
};
stream.respond(headers);传给回调函数的标头对象将有一个 null 原型。
这意味着 Object.prototype.toString() 和 Object.prototype.hasOwnProperty() 等普通 JavaScript 对象方法将不起作用。
对于传入的标头:
:status标头转换为number。- 重复的
:status,:method,:authority,:scheme,:path,:protocol,age,authorization,access-control-allow-credentials,access-control-max-age,access-control-request-method,content-encoding,content-language,content-length,content-location,content-md5,content-range,content-type,date,dnt,etag,expires,from,host,if-match,if-modified-since,if-none-match,if-range,if-unmodified-since,last-modified,location,max-forwards,proxy-authorization,range,referer,retry-after,tk,upgrade-insecure-requests,user-agent或x-content-type-options被丢弃。 set-cookie始终是数组。 重复项被添加到数组中。- 对于重复的
cookie标头,其值使用 '; ' 连接。 - 对于所有其他标头,其值使用 ', ' 连接。
const http2 = require('node:http2');
const server = http2.createServer();
server.on('stream', (stream, headers) => {
console.log(headers[':path']);
console.log(headers.ABC);
});Headers are represented as own-properties on JavaScript objects. The property
keys will be serialized to lower-case. Property values should be strings (if
they are not they will be coerced to strings) or an Array of strings (in order
to send more than one value per header field).
const headers = {
':status': '200',
'content-type': 'text-plain',
'ABC': ['has', 'more', 'than', 'one', 'value'],
};
stream.respond(headers);Header objects passed to callback functions will have a null prototype. This
means that normal JavaScript object methods such as
Object.prototype.toString() and Object.prototype.hasOwnProperty() will
not work.
For incoming headers:
- The
:statusheader is converted tonumber. - Duplicates of
:status,:method,:authority,:scheme,:path,:protocol,age,authorization,access-control-allow-credentials,access-control-max-age,access-control-request-method,content-encoding,content-language,content-length,content-location,content-md5,content-range,content-type,date,dnt,etag,expires,from,host,if-match,if-modified-since,if-none-match,if-range,if-unmodified-since,last-modified,location,max-forwards,proxy-authorization,range,referer,retry-after,tk,upgrade-insecure-requests,user-agentorx-content-type-optionsare discarded. set-cookieis always an array. Duplicates are added to the array.- For duplicate
cookieheaders, the values are joined together with '; '. - For all other headers, the values are joined together with ', '.
const http2 = require('node:http2');
const server = http2.createServer();
server.on('stream', (stream, headers) => {
console.log(headers[':path']);
console.log(headers.ABC);
});