proxy.ProxyInfo
Enthält Informationen über einen Proxy. Dieses Objekt oder ein Array dieser Objekte wird vom Listener an proxy.onRequest
zurückgegeben. Es weist den Browser an, ob die Anfrage über einen Proxy erfolgen soll und wenn ja, welchen Proxy er verwenden soll.
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. Es kann einen der folgenden Werte annehmen:"direct"
: Die Anfrage nicht über einen Proxy leiten. Wenn dieser Wert angegeben ist, werden alle anderen Eigenschaften dieses Objekts ignoriert. Diese Einstellung überschreibt jedoch keine vom Benutzer gesetzten Proxys. Verwenden Sieproxy.settings
, um zu überprüfen, ob ein manueller Proxy verwendet wird, und falls notwendig, diese Einstellungen für Änderungen mittelsBrowserSetting.onChange
zu überwachen."http"
: HTTP-Proxy (oder SSL CONNECT für HTTPS)"https"
: HTTP-Proxying über TLS-Verbindung zum Proxy"socks"
: SOCKS v5 Proxy"socks4"
: SOCKS v4 Proxy
host
-
string
. Der Hostname des Proxy-Servers. Obligatorisch, es sei denn,type
ist"direct"
. port
-
number
. Die Portnummer des Proxy-Servers. Obligatorisch, es sei denn,type
ist"direct"
. username
-
string
. Benutzername für den Proxydienst. Dies ist mit "socks" verwendbar. Für HTTP-Proxy-Autorisierungen verwenden SiewebRequest.onAuthRequired
. password
-
string
. Passwort für den Proxydienst. Dies ist mit "socks" verwendbar. Für HTTP-Proxy-Autorisierungen verwenden SiewebRequest.onAuthRequired
. proxyDNS
-
boolean
. Wenn true, wird der Proxyserver zur Auflösung bestimmter DNS-Abfragen verwendet (nur mit"socks4"
und"socks"
verwendbar). Standardwert istfalse
. failoverTimeout
-
number
. Failover-Timeout in Sekunden. Wenn die Verbindung zum Proxyserver innerhalb dieser Anzahl von Sekunden fehlschlägt, wird der nächste Proxyserver in dem vomproxy.onRequest
-Listener zurückgegebenen Array verwendet. -
string
. Wenn gesetzt, wird dies an denProxy-Authorization
Request-Header gesendet, der an HTTP- oder HTTPS-Proxys als Teil einer CONNECT Anfrage gesendet wird. Wird verwendet, um sich bei HTTP- und HTTPS-Proxys zu authentifizieren, die nicht-herausforderungsbasierte Authentifizierung zulassen.Beispielsweise, wenn Sie "Benutzername" und "Passwort" für die "Basic"-Authentifizierung senden möchten, können Sie die Eigenschaft
proxyAuthorizationHeader
aufBasic dXNlcm5hbWU6cGFzc3dvcmQ=
setzen. connectionIsolationKey
Optional-
string
. Ein optionaler Schlüssel, der für zusätzliche Isolation dieser Proxy-Verbindung verwendet wird.