new Agent([options])

• options <Object> 可在代理上设置的可配置选项集合。可以包含以下字段：
  • keepAlive <boolean> 即使没有未完成的请求，也保持套接字存在，以便将来可以使用这些套接字而无需重新建立 TCP 连接。不要与 Connection 头的 keep-alive 值混淆。使用 agent 时，总是会发送 Connection: keep-alive 头，除非明确指定了 Connection 头，或者 keepAlive 和 maxSockets 选项分别设置为 false 和 Infinity，在这种情况下将使用 Connection: close。默认值： false.
  • keepAliveMsecs <number> 使用 keepAlive 选项时，指定 TCP Keep-Alive 数据包的 初始延迟。当 keepAlive 选项为 false 或 undefined 时，此项将被忽略。默认值： 1000。
  • maxSockets <number> 每个主机允许的最大套接字数。如果同一主机打开多个并发连接，每个请求将使用新的套接字，直到达到 maxSockets 值。如果主机尝试打开的连接数超过 maxSockets，额外的请求将进入待处理请求队列，并在现有连接终止时进入活动连接状态。这确保了在任何时间点，从给定主机最多只有 maxSockets 个活动连接。默认值: Infinity。
  • maxTotalSockets <number> 允许所有主机使用的最大套接字总数。每个请求将使用一个新的套接字，直到达到最大值。 默认值： Infinity。
  • maxFreeSockets <number> 每个主机保持空闲状态的最大套接字数量。仅在 keepAlive 设置为 true 时有效。默认值： 256。
  • scheduling <string> 在选择下一个可用套接字时应用的调度策略。它可以是 'fifo' 或 'lifo'。 这两种调度策略的主要区别在于 'lifo' 会选择最近使用的套接字，而 'fifo' 会选择最久未使用的套接字。 在请求速率较低的情况下，'lifo' 调度可以降低选择已因不活动而被服务器关闭的套接字的风险。 在请求速率较高的情况下，'fifo' 调度可以最大化打开的套接字数量，而 'lifo' 调度会尽可能保持套接字数量较少。 默认值: 'lifo'。
  • timeout <number> 套接字超时（毫秒）。这将设置套接字创建时的超时时间。

socket.connect() 中的 options 也受支持。

要配置其中的任何一个，必须创建一个自定义的 http.Agent 实例。

🌐 To configure any of them, a custom http.Agent instance must be created.

import { Agent, request } from 'node:http';
const keepAliveAgent = new Agent({ keepAlive: true });
options.agent = keepAliveAgent;
request(options, onResponseCallback);const http = require('node:http');
const keepAliveAgent = new http.Agent({ keepAlive: true });
options.agent = keepAliveAgent;
http.request(options, onResponseCallback);拷贝