Node.js http.ClientRequest.setHeader() 方法

简介

http.ClientRequest.setHeader() 方法用于设置 HTTP 请求的头部信息。它允许程序员在发送 HTTP 请求之前添加自定义头部，以实现更灵活的网络通信。

语法

request.setHeader(name, value);

参数

• name (String): 要设置的头部字段的名称。
• value (String): 头部字段的值。

返回值

该方法没有返回值。

使用示例

以下示例演示了如何使用 setHeader() 方法设置自定义头部信息：

const http = require('http');

// 创建一个 HTTP 请求实例
const options = {
  hostname: 'www.example.com',
  port: 80,
  path: '/',
  method: 'GET'
};

const req = http.request(options, (res) => {
  console.log(`状态码： ${res.statusCode}`);
});

// 设置自定义头部字段
req.setHeader('Content-Type', 'application/json');
req.setHeader('X-Custom-Header', 'custom-value');

// 发送请求
req.end();

在上述例子中，我们使用 http.request() 创建了一个 HTTP 请求实例。然后，通过调用该实例的 setHeader() 方法，分别设置了 Content-Type 和 X-Custom-Header 的值。最后，通过调用 req.end() 方法发送了请求。

头部字段的意义

在 HTTP 请求中，头部字段是用来描述请求的一些属性和参数的信息。常见的头部字段包括：

• Accept: 指定客户端能够接收的响应内容类型。
• User-Agent: 指定客户端的用户代理标识，用于服务器进行识别和适配。
• Content-Type: 指定请求体的内容类型，常见的有 application/json、application/x-www-form-urlencoded 等。
• Authorization: 指定进行身份验证的凭证，常用于发送身份验证信息给服务器。
• Cookie: 指定客户端的 cookie 信息，常用于在多个请求之间保持会话状态。

注意事项

• 头部字段的名称和值都是字符串类型。
• 如果多次调用 setHeader() 方法指定同一字段的值，那么只有最后一次调用的值会被发送到服务器。
• 如果要设置多个值给同一字段，可以使用 request.setHeader(name, [value1, value2]) 的方式。

更多关于 http 模块的信息，请参考 Node.js 官方文档。