proxy.ProxyInfo

Значения этого типа являются объектами. Они содержат следующие свойства:

type

string. Это описывает, нужно ли проксировать запрос вообще и, если нужно, какой тип прокси использовать. Может принимать одно из следующих значений:

• "direct": не проксировать запрос. Если задано это значение, все остальные свойства этого объекта игнорируются. Однако, это значение не переопределяет настройки прокси пользователя. Используйте proxy.settings для проверки, используется ли ручной прокси, и при необходимости отслеживайте эти настройки с помощью BrowserSetting.onChange.
• "http": HTTP-прокси (или SSL CONNECT для HTTPS)
• "https": HTTP-проксирование через TLS-соединение с прокси
• "socks": прокси SOCKS v5
• "socks4": прокси SOCKS v4

host

string. Имя хоста сервера прокси. Обязательно, если type равно "direct".

port

number. Номер порта сервера прокси. Обязательно, если type равно "direct".

username

string. Имя пользователя для службы прокси. Это используется с "socks". Для авторизации HTTP-прокси используйте webRequest.onAuthRequired.

password

string. Пароль для службы прокси. Это используется с "socks". Для авторизации HTTP-прокси используйте webRequest.onAuthRequired.

proxyDNS

boolean. Если true, сервер прокси используется для разрешения определённых запросов DNS (только при использовании "socks4" и "socks"). По умолчанию false.

failoverTimeout

number. Время ожидания переключения (failover) в секундах. Если соединение с сервером прокси не удаётся установить после этого количества секунд, используется следующий сервер прокси в массиве, возвращённом слушателем proxy.onRequest.

proxyAuthorizationHeader

string. Эта строка, если она не пуста, передаётся напрямую как значение заголовку запроса Proxy-Authorization, отправляемому HTTPS-прокси в рамках HTTPS и CONNECT-запросов. Другими словами, это можно использовать для прямой аутентификации к HTTPS-прокси, которые допускают (не требующую запроса) аутентификацию.

Например, если вы хотите отправить "username" и "password" для аутентификации "basic", вы можете установить свойство proxyAuthorizationHeader в Basic dXNlcm5hbWU6cGFzc3dvcmQ=

connectionIsolationKey Необязательно

string. Необязательный ключ, используемый для дополнительной изоляции этого соединения с прокси. Применимо только к HTTPS-прокси.