proxy.ProxyInfo

此类型的值为对象。它们包含以下属性

type

string. 这描述是否代理以及如果代理，使用哪种代理。它可能取以下值之一

• "direct": 不代理请求。如果给出此值，则此对象的其余所有属性都将被忽略。但是，此设置不会覆盖 用户设置的代理。使用 proxy.settings 检查是否正在使用手动代理，以及如果需要，使用 BrowserSetting.onChange 监控这些设置的更改。
• "http": HTTP 代理（或 HTTPS 的 SSL CONNECT）
• "https": 通过 TLS 连接到代理的 HTTP 代理
• "socks": SOCKS v5 代理
• "socks4": SOCKS v4 代理

host

string. 代理服务器的主机名。除非 type 为 "direct"，否则为必需。

port

number. 代理服务器的端口号。除非 type 为 "direct"，否则为必需。

username

string. 代理服务的用户名。这可用于 "socks"。对于 HTTP 代理授权，请使用 webRequest.onAuthRequired.

password

string. 代理服务的密码。这可用于 "socks"。对于 HTTP 代理授权，请使用 webRequest.onAuthRequired.

proxyDNS

boolean. 如果为真，则使用代理服务器解析某些 DNS 查询（仅可用于 "socks4" 和 "socks"）。默认为 false。

failoverTimeout

number. 故障转移超时（以秒为单位）。如果连接在指定秒数后无法连接到代理服务器，则将使用 proxy.onRequest 监听器返回的数组中的下一个代理服务器。

proxyAuthorizationHeader

string. 设置时，此值将传递到 Proxy-Authorization 请求头，该请求头作为 CONNECT 请求的一部分发送到 HTTP 或 HTTPS 代理。用于对允许非挑战性身份验证的 HTTP 和 HTTPS 代理进行身份验证。

例如，如果您想为 "basic" 身份验证发送 "username" 和 "password"，您可以将 proxyAuthorizationHeader 属性设置为 Basic dXNlcm5hbWU6cGFzc3dvcmQ=

connectionIsolationKey 可选

string. 用于进一步隔离此代理连接的可选密钥。