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。用於此代理連線的額外隔離的可選鍵。

瀏覽器相容性