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.

autoConfigUrl Optional

string. Eine URL zur Konfiguration des Proxys.

autoLogin Optional

boolean. Keine Aufforderung zur Authentifizierung, wenn das Passwort gespeichert ist. Standardmäßig false.

ftp Optional

string. Die Adresse des FTP-Proxys. Kann einen Port enthalten.

http Optional

string. Die Adresse des HTTP-Proxys. Kann einen Port enthalten.

httpProxyAll Optional

boolean. Verwenden Sie den HTTP-Proxyserver für alle Protokolle. Standardmäßig false.

passthrough Optional

string. Eine kommagetrennte Liste von Hosts, die nicht über den Proxy geleitet werden sollten. Kann definiert werden als:

  • HOST_NAME[:PORT], zum Beispiel: example.com oder example.com:1234
  • IP_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.1 und [::1] werden nie über den Proxy geleitet.

proxyDNS Optional

boolean. Ob DNS über einen SOCKS-Proxy geleitet wird. Standardmäßig true bei Verwendung von SOCKS5 und false bei Verwendung von SOCKS4. Vor Firefox 128 war der Standardwert false für SOCKS4 und SOCKS5.

proxyType Optional

string. Der Typ des zu verwendenden Proxys. Mögliche Werte sind: "none", "autoDetect", "system", "manual", "autoConfig". Standardmäßig "system".

socks Optional

string. Die Adresse des SOCKS-Proxys. Kann einen Port enthalten.

socksVersion Optional

integer. Die Version des SOCKS-Proxys. Kann 4 oder 5 sein. Standardmäßig 5.

ssl Optional

string. Die Adresse des TLS/SSL-Proxys. Kann einen Port enthalten.

Beispiele

js
let proxySettings = {
  proxyType: "manual",
  http: "http://proxy.org:8080",
  socksVersion: 4,
  passthrough: ".example.org",
};

browser.proxy.settings.set({ value: proxySettings });

Browser-Kompatibilität