proxy.settings

Объект BrowserSetting, который можно использовать для изменения настроек прокси-сервера браузера.

Примечание: Изменение настроек прокси-сервера требует доступа к окну частного просмотра, поскольку настройки прокси-сервера влияют на окна частного и обычного просмотра. Возможность расширения получить доступ к окнам частного просмотра зависит от настроек пользователя. Подробнее см. Расширения в режиме частного просмотра. Ваше расширение может проверить, имеет ли оно доступ к окнам частного просмотра, используя extension.isAllowedIncognitoAccess. Если у вашего расширения нет разрешения на доступ к окнам частного просмотра, вызовы proxy.settings.set() приведут к исключению.

Основное значение — это объект со свойствами, перечисленными ниже.

При установке этого объекта все свойства являются необязательными. Обратите внимание, что любые пропущенные свойства будут сброшены до своего значения по умолчанию.

autoConfigUrl Необязательно: string. URL для настройки прокси-сервера.
autoLogin Необязательно: boolean. Не запрашивать авторизацию, если пароль сохранён. По умолчанию false.
ftp Необязательно Устаревшее: string. Адрес FTP прокси-сервера. Может включать порт.
http Необязательно: string. Адрес HTTP прокси-сервера. Может включать порт.
httpProxyAll Необязательно: boolean. Использовать HTTP прокси-сервер для всех протоколов. По умолчанию false.
passthrough Необязательно: string. Список хостов, которые не должны проходить через прокси. По умолчанию "localhost, 127.0.0.1".
proxyDNS Необязательно: boolean. Проксировать DNS при использовании SOCKS5. По умолчанию false.
proxyType Необязательно: string. Тип используемого прокси-сервера. Может принимать следующие значения: "none", "autoDetect", "system", "manual", "autoConfig". По умолчанию "system".
socks Необязательно: string. Адрес SOCKS прокси-сервера. Может включать порт.
socksVersion Необязательно: integer. Версия SOCKS прокси-сервера. Может быть 4 или 5. По умолчанию 5.
ssl Необязательно: string. Адрес SSL прокси-сервера. Может включать порт.

Примеры

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

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

Совместимость с браузерами

	Рабочие столы						Мобильные устройства
	Chrome	Edge	Firefox	Internet Explorer	Opera	Safari	WebView Android	Chrome Android	Firefox для Android	Opera Android	Safari на IOS	Samsung Internet
`settings`	Нет	Нет	60 Начиная с версии 88, настройка `ftp` не имеет эффекта, так как FTP больше не поддерживается (см. баг 1626365).	?	Нет	Нет	?	?	Нет	?	Нет	?

© 2005–2023 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Mozilla/Add-ons/WebExtensions/API/proxy/settings