proxy.register()

Вы можете обмениваться сообщениями между файлом PAC и страницей фонового скрипта вашего расширения (или любой другой страницы с привилегиями, например, страницей всплывающего окна) с помощью runtime.sendMessage() и runtime.onMessage.

Чтобы отправить сообщение в файл PAC, необходимо установить опцию toProxyScript:

// background.js

// Log any messages from the proxy.
browser.runtime.onMessage.addListener((message, sender) => {
  if (sender.url === browser.extension.getURL(proxyScriptURL)) {
    console.log(message);
  }
});

let messageToProxy = {
  enabled: true,
  foo: "A string",
  bar: 1234
};

browser.runtime.sendMessage(messageToProxy, {toProxyScript: true});

// pac.js

browser.runtime.onMessage.addListener((message) => {
  if (message.enabled) {
    browser.runtime.sendMessage("I'm enabled!");
  }
});

Базовая синтаксическая структура файла PAC описана в документации PAC, но реализация, используемая API прокси, отличается от стандартного дизайна PAC несколькими способами, которые описаны в этом разделе.

Стандартная FindProxyForURL() возвращает строку. В Firefox 55 и 56 файл PAC, используемый с API прокси, также возвращает строку. В Firefox 55 только вы должны передавать аргумент в значение возврата "DIRECT", даже если он не требует аргумента.

Начиная с Firefox 57, FindProxyForURL() может по-прежнему возвращать строку, но в качестве альтернативы (и предпочтительно) возвращает массив объектов proxy.ProxyInfo.

Если массив содержит более одного объекта, все ProxyInfo объекты после первого представляют собой резервные варианты: если прокси в позиции N в массиве недоступен, когда срок действия его ProxyInfo.failoverTimeout истекает, браузер попробует прокси в позиции N+1.

Например:

const proxySpecification = [
  {
    type: "socks",
    host: "foo.com",
    port: 1080,
    proxyDNS: true,
    failoverTimeout: 5
  },
  {
    type: "socks",
    host: "bar.com",
    port: 1060,
  }
];

Первый прокси в массиве будет проверен в первую очередь. Если он не ответит в failoverTimeout секунды, будет проверен следующий, и так до конца массива.

Глобальные вспомогательные функции, обычно доступные для файлов PAC (isPlainHostName(), dnsDomainIs() и т. д.) недоступны.

Код, выполняемый в файле PAC, не получает доступ к:

• любым функциям DOM (например, window или любым его свойствам)
• каким-либо API WebExtension, кроме runtime.sendMessage() и runtime.onMessage
• API консоли Console API — для регистрации сообщений из PAC отправьте сообщение в фоновый скрипт:

//  pac.js

// send the log message to the background script
browser.runtime.sendMessage(`Proxy-blocker: blocked ${url}`);

// background-script.js

function handleMessage(message, sender) {
  // only handle messages from the proxy script
  if (sender.url !== browser.extension.getURL(proxyScriptURL)) {
    return;
  }
  console.log(message);
}

browser.runtime.onMessage.addListener(handleMessage);

url

String. URL, указывающий на файл PAC для загрузки. Файлы PAC должны быть включены в расширение, и url должен быть относительным к файлу manifest.json расширения.

A Promise, который будет выполнен без аргументов, когда файл PAC будет зарегистрирован, или отклонен, если произошла ошибка.