proxy.settings

Ein BrowserSetting Objekt, das verwendet wird, um die Proxy-Einstellungen des Browsers zu ändern.

Hinweis: Das Ändern von Proxy-Einstellungen erfordert Zugriff auf private Browser-Fenster, da Proxy-Einstellungen sowohl private als auch nicht-private Fenster betreffen. Ob eine Erweiterung auf private Browser-Fenster zugreifen kann, liegt in der Kontrolle des Benutzers. Details finden Sie unter Erweiterungen im privaten Modus. Ihre Erweiterung kann überprüfen, ob sie Zugriff auf private Browser-Fenster hat, indem sie extension.isAllowedIncognitoAccess verwendet. Wenn Ihre Erweiterung keine Berechtigung für private Fenster hat, werfen Aufrufe von proxy.settings.set() eine Ausnahme.

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 zum Konfigurieren 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. Den HTTP-Proxyserver für alle Protokolle verwenden. Standardmäßig false.

passthrough Optional

string. Eine kommagetrennte Liste von Hosts, die nicht über einen Proxy geleitet werden sollen. 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 die Proxy-Umgehung für alle Hostnamen zu aktivieren, 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 beim Verwenden eines SOCKS-Proxys DNS über Proxy geleitet werden soll. 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 zu verwendende Proxy-Typ. Dies kann folgende Werte annehmen: "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