runtime.connect()

extensionId Необязательный

string. Идентификатор расширения, к которому нужно подключиться. Если целевой объект явно установил ID с помощью ключа browser_specific_settings в manifest.json, то extensionId должен иметь это значение. В противном случае он должен иметь ID, сгенерированный для целевого объекта.

connectInfo Необязательный

object. Детали подключения:

name Необязательный

string. Будет передан в runtime.onConnect для процессов, ожидающих события подключения.

includeTlsChannelId Необязательный

boolean. Будет ли идентификатор канала TLS передан в runtime.onConnectExternal для процессов, ожидающих события подключения.

runtime.Port. Порт, через который можно отправлять и получать сообщения. Событие onDisconnect порта срабатывает, если расширение не существует.

Этот скрипт контента:

• подключается к скрипту фонового процесса и сохраняет Port в переменной под названием myPort.
• прослушивает сообщения на myPort и регистрирует их.
• отправляет сообщения скрипту фонового процесса, используя myPort, когда пользователь щелкает по документу.

// content-script.js

let myPort = browser.runtime.connect({name:"port-from-cs"});
myPort.postMessage({greeting: "hello from content script"});

myPort.onMessage.addListener((m) => {
  console.log("In content script, received message from background script: ");
  console.log(m.greeting);
});

document.body.addEventListener("click", () => {
  myPort.postMessage({greeting: "they clicked the page!"});
});

Соответствующий скрипт фонового процесса:

• прослушивает попытки подключения от скрипта контента.
• при получении попытки подключения:
  • сохраняет порт в переменную под названием portFromCS.
  • отправляет скрипту контента сообщение, используя порт.
  • начинает прослушивать сообщения, полученные по порту, и регистрирует их.
• отправляет сообщения скрипту контента, используя portFromCS, когда пользователь щелкает по действию расширения в браузере.

// background-script.js

let portFromCS;

function connected(p) {
  portFromCS = p;
  portFromCS.postMessage({greeting: "hi there content script!"});
  portFromCS.onMessage.addListener((m) => {
    console.log("In background script, received message from content script")
    console.log(m.greeting);
  });
}

browser.runtime.onConnect.addListener(connected);

browser.browserAction.onClicked.addListener(() => {
  portFromCS.postMessage({greeting: "they clicked the button!"});
});