runtime.onInstalled

Вызывается при первом установлении расширения, при обновлении расширения до новой версии и при обновлении браузера до новой версии.

Обратите внимание, что runtime.onInstalled отличается от management.onInstalled. Событие runtime.onInstalled срабатывает только для вашего расширения. Событие browser.management.onInstalled срабатывает для всех расширений.

Синтаксис

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

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

addListener(callback): Добавляет обработчик к этому событию.
removeListener(listener): Прекращает прослушивание этого события. Аргумент listener — обработчик, который нужно удалить.
hasListener(listener): Проверяет, зарегистрирован ли обработчик listener для этого события. Возвращает true , если он прослушивается, и false в противном случае.

Синтаксис addListener

Параметры

function

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

details

Объект со следующими свойствами:

id Необязательно: string. Идентификатор импортированного расширения общего модуля, которое обновилось. Присутствует только если значение reason равно shared_module_update.
previousVersion Необязательно: string. Предыдущая версия только что обновлённого расширения. Присутствует только если значение reason равно update.
reason: Значение runtime.OnInstalledReason, указывающее причину, по которой было отправлено это событие.
temporary: boolean. True, если дополнение было установлено временно. Например, используя страницу "about:debugging" в Firefox или используя web-ext run. False в противном случае.

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

	Рабочий стол						Мобильные устройства
	Chrome	Edge	Firefox	Internet Explorer	Opera	Safari	WebView Android	Chrome Android	Firefox для Android	Opera Android	Safari в iOS	Samsung Internet
`onInstalled`	22	14	52 До версии 55 это событие не срабатывало для временно установленных дополнений.	?	15	14	?	?	52 До версии 55 это событие не срабатывало для временно установленных дополнений.	?	15	?

Примеры

При установке расширения выведите причину установки и откройте https://example.com:

function handleInstalled(details) {
  console.log(details.reason);
  browser.tabs.create({
    url: "https://example.com"
  });
}

browser.runtime.onInstalled.addListener(handleInstalled);

Примеры расширений

runtime-examples

Примечание: Этот API основан на API chrome.runtime Chromium. Данная документация взята из runtime.json кода Chromium.

© 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/runtime/onInstalled