runtime.onMessageExternal

browser.runtime.onMessageExternal.addListener()
browser.runtime.onMessageExternal.removeListener(listener)
browser.runtime.onMessageExternal.hasListener(listener)

События имеют три функции:

addListener(callback)

Добавляет слушателя к этому событию.

removeListener(listener)

Прекращает прослушивание этого события. Аргумент listener — это слушатель, который нужно удалить.

hasListener(listener)

Проверяет, зарегистрирован ли слушатель listener для этого события. Возвращает true, если он прослушивает, false, в противном случае.

function

Функция обратного вызова, которая вызывается при возникновении этого события. Функция получает следующие аргументы:

message

object. Само сообщение. Это объект, преобразуемый в JSON.

sender

Объект runtime.MessageSender, представляющий отправителя сообщения.

sendResponse

Функция для вызова (не более одного раза) для отправки ответа на сообщение. Функция принимает один аргумент, который может быть любым объектом, преобразуемым в JSON. Этот аргумент возвращается отправителю сообщения.

Если в одном документе есть более одного слушателя onMessageExternal, то только один может отправить ответ.

Чтобы отправить ответ синхронно, вызовите sendResponse до возвращения функции слушателя. Чтобы отправить ответ асинхронно, сделайте одно из следующих:

• сохраните ссылку на аргумент sendResponse, и верните true из функции слушателя. Затем вы можете вызвать sendResponse после возвращения функции слушателя.
• верните Promise из функции слушателя и разрешите промис, когда ответ будет готов.

В этом примере расширение "blue@mozilla.org" отправляет сообщение расширению "red@mozilla.org":

// sender: browser.runtime.id === "blue@mozilla.org"

// Send a message to the extension whose ID is "red@mozilla.org"
browser.runtime.sendMessage(
    "red@mozilla.org",
    "my message"
  );

// recipient: browser.runtime.id === "red@mozilla.org"

function handleMessage(message, sender) {
  // check that the message is from "blue@mozilla.org"
  if (sender.id === "blue@mozilla.org") {
    // process message
  }
}

browser.runtime.onMessageExternal.addListener(handleMessage);