proxy.settings
Ein BrowserSetting-Objekt, das verwendet wird, um die Proxy-Einstellungen des Browsers zu ändern.
Hinweis:
Das Ändern der Proxy-Einstellungen erfordert den Zugriff auf das private Fenster, da die Proxy-Einstellungen sowohl private als auch nicht-private Fenster betreffen. Ob eine Erweiterung auf private Fenster zugreifen kann, liegt in der Kontrolle des Benutzers. Weitere Details finden Sie unter Erweiterungen im privaten Modus. Ihre Erweiterung kann prüfen, ob sie Zugriff auf private Fenster hat, indem sie extension.isAllowedIncognitoAccess verwendet. Wenn Ihre Erweiterung keine Berechtigung für private Fenster hat, lösen Aufrufe von proxy.settings.set() eine Ausnahme aus.
Der zugrunde liegende Wert ist ein Objekt. Beim Setzen dieses Objekts sind alle Eigenschaften optional. Alle ausgelassenen Eigenschaften werden auf ihren Standardwert zurückgesetzt.
autoConfigUrlOptional-
string. Eine URL zur Konfiguration des Proxys. autoLoginOptional-
boolean. Keine Aufforderung zur Authentifizierung, wenn das Passwort gespeichert ist. Standardmäßigfalse. ftpOptional Veraltet-
string. Die Adresse des FTP-Proxys. Kann einen Port enthalten. httpOptional-
string. Die Adresse des HTTP-Proxys. Kann einen Port enthalten. httpProxyAllOptional-
boolean. Verwenden Sie den HTTP-Proxyserver für alle Protokolle. Standardmäßigfalse. passthroughOptional-
string. Eine kommagetrennte Liste von Hosts, die nicht über den Proxy geleitet werden sollten. Kann definiert werden als:HOST_NAME[:PORT], zum Beispiel:example.comoderexample.com:1234IP_LITERAL[:PORT]IP_LITERAL/PREFIX_LENGTH_IN_BITS, unter Verwendung der CIDR-Notation<local>, um für alle Hostnamen, die keine Punkte enthalten, das Proxieren zu umgehen.
Sie können IPv6-Adressen verwenden. Zum Beispiel
[::123].Die Hosts
localhost,127.0.0.1und[::1]werden nie über den Proxy geleitet. proxyDNSOptional-
boolean. Ob DNS über einen SOCKS-Proxy geleitet wird. Standardmäßigtruebei Verwendung von SOCKS5 undfalsebei Verwendung von SOCKS4. Vor Firefox 128 war der Standardwertfalsefür SOCKS4 und SOCKS5. proxyTypeOptional-
string. Der Typ des zu verwendenden Proxys. Mögliche Werte sind: "none", "autoDetect", "system", "manual", "autoConfig". Standardmäßig "system". socksOptional-
string. Die Adresse des SOCKS-Proxys. Kann einen Port enthalten. socksVersionOptional-
integer. Die Version des SOCKS-Proxys. Kann 4 oder 5 sein. Standardmäßig 5. sslOptional-
string. Die Adresse des TLS/SSL-Proxys. Kann einen Port enthalten.
Beispiele
let proxySettings = {
proxyType: "manual",
http: "http://proxy.org:8080",
socksVersion: 4,
passthrough: ".example.org",
};
browser.proxy.settings.set({ value: proxySettings });
Browser-Kompatibilität
Loading…