proxy.settings
Ein BrowserSetting
Objekt, das verwendet wird, um die Proxy-Einstellungen des Browsers zu ändern.
Hinweis: Das Ändern von Proxy-Einstellungen erfordert den Zugriff auf private Browsing-Fenster, da Proxy-Einstellungen sowohl private als auch nicht-private Fenster beeinflussen. Ob eine Erweiterung auf private Browsing-Fenster zugreifen kann, liegt in der Kontrolle des Benutzers. Siehe Erweiterungen im privaten Browsing für weitere Details. Ihre Erweiterung kann prüfen, ob sie Zugang zu privaten Browsing-Fenstern hat, indem sie extension.isAllowedIncognitoAccess
verwendet. Wenn Ihre Erweiterung keine Erlaubnis für private Fenster hat, werfen Aufrufe zu proxy.settings.set()
eine Ausnahme.
Der zugrunde liegende Wert ist ein Objekt. Wenn Sie dieses Objekt festlegen, sind alle Eigenschaften optional. Alle ausgelassenen Eigenschaften werden auf ihren Standardwert zurückgesetzt.
autoConfigUrl
Optional-
string
. Eine URL, die verwendet wird, um den Proxy zu konfigurieren. autoLogin
Optional-
boolean
. Kein Prompt für Authentifizierung, wenn das Passwort gespeichert ist. Standard istfalse
. ftp
Optional Veraltet-
string
. Die Adresse des FTP-Proxys. Kann einen Port umfassen. http
Optional-
string
. Die Adresse des HTTP-Proxys. Kann einen Port umfassen. httpProxyAll
Optional-
boolean
. Verwenden Sie den HTTP-Proxyserver für alle Protokolle. Standard istfalse
. passthrough
Optional-
string
. Eine durch Kommas getrennte Liste von Hosts, die nicht über einen Proxy geleitet werden sollen. Kann definiert werden als:HOST_NAME[:PORT]
, zum Beispiel:example.com
oderexample.com:1234
IP_LITERAL[:PORT]
IP_LITERAL/PREFIX_LENGTH_IN_BITS
, unter Verwendung der CIDR-Notation<local>
, um das Proxying für alle Hostnamen zu umgehen, die keine Punkte enthalten.
Sie können IPv6-Adressen verwenden. Zum Beispiel,
[::123]
.Die Hosts
localhost
,127.0.0.1
und[::1]
werden niemals über einen Proxy geleitet. proxyDNS
Optional-
boolean
. Ob DNS verwendet werden soll, wenn ein SOCKS-Proxy verwendet wird. Standard isttrue
bei Verwendung von SOCKS5 undfalse
bei Verwendung von SOCKS4. Vor Firefox 128 war der Standardwertfalse
für SOCKS4 und SOCKS5. proxyType
Optional-
string
. Der zu verwendende Proxy-Typ. Dies kann „none“, „autoDetect“, „system“, „manual“, „autoConfig“ sein. Standard ist „system“. socks
Optional-
string
. Die Adresse des SOCKS-Proxys. Kann einen Port umfassen. socksVersion
Optional-
integer
. Die Version des SOCKS-Proxys. Kann 4 oder 5 sein. Standard ist 5. ssl
Optional-
string
. Die Adresse des TLS/SSL-Proxys. Kann einen Port umfassen.
Beispiele
let proxySettings = {
proxyType: "manual",
http: "http://proxy.org:8080",
socksVersion: 4,
passthrough: ".example.org",
};
browser.proxy.settings.set({ value: proxySettings });
Browser-Kompatibilität
BCD tables only load in the browser