proxy.ProxyInfo

类型

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

type

string。这描述了是否代理，如果代理，则使用哪种类型的代理。它可以取以下值之一

• "direct"：不代理请求。如果给出此值，则忽略此对象的所有其他属性。但是，此设置不会覆盖 用户设置的代理。使用 proxy.settings 来检查是否正在使用手动代理，并在必要时使用 BrowserSetting.onChange 监视这些设置的变化。
• "http"：HTTP 代理（或 HTTPS 的 SSL CONNECT）
• "https"：通过 TLS 连接到代理进行 HTTP 代理
• "socks"：SOCKS v5 代理
• "socks4"：SOCKS v4 代理

主机

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

port

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

username

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

密码

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

proxyDNS

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

failoverTimeout

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

proxyAuthorizationHeader

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

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

connectionIsolationKey 可选

string。用于此代理连接的额外隔离的可选键。

浏览器兼容性