Node.js http.ServerResponse response.setHeader(name, value)用法及代码示例

response.setHeader(name, value)

参数

• name <string>
• value <any>
• 返回： <http.ServerResponse>

返回响应对象。

为隐式标头设置单个标头值。如果此标头已存在于to-be-sent 标头中，则其值将被替换。在此处使用字符串数组发送多个具有相同名称的标头。非字符串值将不加修改地存储。因此， response.getHeader() 可能会返回非字符串值。但是，非字符串值将被转换为字符串以进行网络传输。相同的响应对象返回给调用者，以启用调用链。

response.setHeader('Content-Type', 'text/html');

或者

response.setHeader('Set-Cookie', ['type=ninja', 'language=javascript']);

尝试设置包含无效字符的标头字段名称或值将导致引发 TypeError 。

当标头已设置为 response.setHeader() 时，它们将与传递给 response.writeHead() 的任何标头合并，并且传递给 response.writeHead() 的标头优先。

// Returns content-type = text/plain
const server = http.createServer((req, res) => {
  res.setHeader('Content-Type', 'text/html');
  res.setHeader('X-Foo', 'bar');
  res.writeHead(200, { 'Content-Type': 'text/plain' });
  res.end('ok');
});

如果调用了 response.writeHead() 方法而该方法没有被调用，它将直接将提供的header值写入网络通道而不进行内部缓存，并且header上的 response.getHeader() 不会产生预期的结果。如果需要潜在的未来检索和修改标题的渐进填充，请使用 response.setHeader() 而不是 response.writeHead() 。