proxy.ProxyInfo

Typ

Werte dieses Typs sind Objekte. Sie enthalten die folgenden Eigenschaften:

type

string. Dies beschreibt, ob überhaupt ein Proxy verwendet werden soll und wenn ja, welche Art von Proxy. Mögliche Werte sind:

• "direct": Keine Proxy-Verwendung für die Anfrage. Wenn dieser Wert angegeben wird, werden alle anderen Eigenschaften dieses Objekts ignoriert. Diese Einstellung überschreibt jedoch nicht vom Benutzer gesetzte Proxys. Verwenden Sie proxy.settings, um zu überprüfen, ob ein manueller Proxy verwendet wird, und überwachen Sie diese Einstellungen gegebenenfalls auf Änderungen mit BrowserSetting.onChange.
• "http": HTTP-Proxy (oder SSL CONNECT für HTTPS)
• "https": HTTP-Proxying über TLS-Verbindung zum Proxy
• "masque": MASQUE-Proxy (Tunnel über QUIC, wie in RFC 9298 definiert)
• "socks": SOCKS v5-Proxy
• "socks4": SOCKS v4-Proxy

host

string. Der Hostname des Proxy-Servers. Pflichtfeld, es sei denn, type ist "direct".

port

number. Die Portnummer des Proxy-Servers. Pflichtfeld, es sei denn, type ist "direct".

masqueTemplate

string. Das URI-Template für den MASQUE-Proxy, beginnend mit dem Pfadbestandteil der URI. Dies muss die Template-Variablen target_host und target_port enthalten, wie in RFC 9298 definiert. Zum Beispiel: /.well-known/masque/udp/{target_host}/{target_port}/. Muss gesetzt werden, wenn der Proxytyp "masque" ist.

username Optional

string. Benutzername für den Proxy-Dienst. Dies ist mit "socks" verwendbar. Für HTTP-Proxy-Authentifizierungen verwenden Sie webRequest.onAuthRequired. Darf nicht gesetzt werden, wenn der Proxy "masque" ist.

password Optional

string. Passwort für den Proxy-Dienst. Dies ist mit "socks" verwendbar. Für HTTP-Proxy-Authentifizierungen verwenden Sie webRequest.onAuthRequired. Darf nicht gesetzt werden, wenn der Proxy "masque" ist.

proxyDNS

boolean. Wenn wahr, wird der Proxy-Server verwendet, um bestimmte DNS-Anfragen zu lösen (nur verwendbar mit "socks4" und "socks"). Standard ist false.

failoverTimeout

number. Failover-Timeout in Sekunden. Schlägt die Verbindung zum Proxy-Server nach dieser Anzahl von Sekunden fehl, wird der nächste Proxy-Server im Array, das vom proxy.onRequest Listener zurückgegeben wird, verwendet.

proxyAuthorizationHeader

string. Wenn gesetzt, wird dies im Proxy-Authorization Anforderungs-Header übergeben, der an HTTP- oder HTTPS-Proxys als Teil einer CONNECT-Anfrage gesendet wird. Verwendet zur Authentifizierung bei HTTP- und HTTPS-Proxys, die nicht-herausfordernde Authentifizierung erlauben.

Wenn Sie beispielsweise "username" und "password" für die "basic" Authentifizierung senden möchten, können Sie die Eigenschaft proxyAuthorizationHeader auf Basic dXNlcm5hbWU6cGFzc3dvcmQ= setzen.

connectionIsolationKey Optional

string. Ein optionaler Schlüssel zur zusätzlichen Isolierung dieser Proxy-Verbindung.

Browser-Kompatibilität