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 der Request über einen Proxy geleitet werden soll und, falls ja, welcher Proxy verwendet werden 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"
: Der Request wird nicht über einen Proxy geleitet. Wenn dieser Wert angegeben wird, werden alle anderen Eigenschaften dieses Objekts ignoriert. Diese Einstellung überschreibt jedoch nicht die vom Benutzer gesetzten Proxy-Einstellungen. Verwenden Sieproxy.settings
, um zu überprüfen, ob ein manueller Proxy verwendet wird und beobachten Sie diese Einstellungen gegebenenfalls für Änderungen mitBrowserSetting.onChange
."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. Erforderlich, es sei denn,type
ist"direct"
. port
-
number
. Die Portnummer des Proxy-Servers. Erforderlich, es sei denn,type
ist"direct"
. username
-
string
. Benutzername für den Proxy-Dienst. Verwendbar mit "socks". Für HTTP-Proxy-Autorisierungen verwenden SiewebRequest.onAuthRequired
. password
-
string
. Passwort für den Proxy-Dienst. Verwendbar mit "socks". Für HTTP-Proxy-Autorisierungen verwenden SiewebRequest.onAuthRequired
. proxyDNS
-
boolean
. Wenn wahr, wird der Proxy-Server zur Auflösung bestimmter DNS-Anfragen verwendet (nur verwendbar mit"socks4"
und"socks"
). Standardmäßigfalse
. failoverTimeout
-
number
. Failover-Timeout in Sekunden. Wenn die Verbindung zum Proxy-Server nach dieser Anzahl von Sekunden fehlschlägt, wird der nächste Proxy-Server im Array, das vom Listenerproxy.onRequest
zurückgegeben wird, verwendet. -
string
. Wenn gesetzt, wird dies demProxy-Authorization
Request-Header hinzugefügt, der an HTTP- oder HTTPS-Proxys als Teil einer CONNECT-Anfrage gesendet wird. Wird zur Authentifizierung bei HTTP- und HTTPS-Proxys verwendet, die nicht-herausfordernde Authentifizierung zulassen.Falls Sie z.B. "username" und "password" für die "basic" Authentifizierung senden wollen, können Sie die Eigenschaft
proxyAuthorizationHeader
aufBasic dXNlcm5hbWU6cGFzc3dvcmQ=
setzen. connectionIsolationKey
Optional-
string
. Ein optionaler Schlüssel, der zur zusätzlichen Isolierung dieser Proxy-Verbindung verwendet wird.