proxy.settings

A BrowserSetting object that can be used to change the browser's proxy settings.

The underlying value is an object with the properties listed below.

When setting this object, all properties are optional. Note that any properties that are omitted will be reset to their default value.

autoConfigUrlOptional

string. A URL to use to configure the proxy.

autoLoginOptional

boolean. Do not prompt for authentication if the password is saved. Defaults to false.

ftpOptional

string. The address of the FTP proxy. Can include a port.

httpOptional

string. The address of the HTTP proxy. Can include a port.

httpProxyAllOptional

boolean. Use the HTTP proxy server for all protocols. Defaults to false.

passthroughOptional

string. A comma-separated list of hosts which should not be proxied. Defaults to "localhost, 127.0.0.1".

proxyDNSOptional

boolean. Proxy DNS when using SOCKS5. Defaults to false.

proxyTypeOptional

string. The type of proxy to use. This may take any one of the following values: "none", "autoDetect", "system", "manual", "autoConfig". Defaults to "system".

socksOptional

string. The address of the SOCKS proxy. Can include a port.

socksVersionOptional

integer. The version of the SOCKS proxy. May be 4 or 5. Defaults to 5.

sslOptional

string. The address of the SSL proxy. Can include a port.

Examples

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

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

Browser compatibility

The compatibility table in this page is generated from structured data. If you'd like to contribute to the data, please check out https://github.com/mdn/browser-compat-data and send us a pull request.