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 ist false.

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 ist false.

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 oder example.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 ist 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 „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

js
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