runtime.onUpdateAvailable

Срабатывает, когда доступно обновление расширения. Это событие позволяет расширению отложить обновление, например, потому что оно находится в середине некоторой операции, которую не следует прерывать.

Если расширение не прослушивает это событие, когда обновление становится доступным, расширение перезагружается немедленно, и обновление применяется. Если расширение прослушивает, обновление будет применено в следующий раз, когда расширение будет перезагружено. Это происходит, если:

браузер перезапущен
расширение отключено и снова включено
расширение явно перезагружается, вызывая runtime.reload().

Синтаксис

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

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

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

Синтаксис addListener

Параметры

callback

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

details: object. Содержит одно свойство, строку с именем version, которая представляет номер версии обновления.

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

	Рабочий стол						Мобильные устройства
	Chrome	Edge	Firefox	Internet Explorer	Opera	Safari	WebView Android	Chrome Android	Firefox for Android	Opera Android	Safari на IOS	Samsung Internet
`onUpdateAvailable`	25	79	51	?	15	Нет	?	?	51	?	Нет	?

Примеры

Прослушивание событий UpdateAvailable:

function handleUpdateAvailable(details) {
  console.log(details.version);
  // Proceed to upgrade the add-on
  browser.runtime.reload();
}

browser.runtime.onUpdateAvailable.addListener(handleUpdateAvailable);

Примечание: Этот 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/onUpdateAvailable