Spec-Zone.ru › Web Extensions

theme.onUpdated

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

  • при установке статической темы
  • когда динамическая тема вызывает theme.update() или theme.reset()
  • при удалении темы.

Обратите внимание, что это событие не срабатывает для изменений встроенных тем.

Синтаксис

browser.theme.onUpdated.addListener(listener)
browser.theme.onUpdated.removeListener(listener)
browser.theme.onUpdated.hasListener(listener)

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

addListener(listener)

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

removeListener(listener)

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

hasListener(listener)

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

Синтаксис addListener

Параметры

callback

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

updateInfo

object. Объект, содержащий две свойства:

theme

object. Если событие было вызвано из-за удаления темы, предоставленной расширением, это будет пустой объект. Если оно было вызвано из-за применения темы, предоставленной расширением, это будет объект theme.Theme, представляющий применённую тему.

windowId Необязательно

integer. Идентификатор окна, для которого была обновлена тема. Если этого свойства нет, значит тема была обновлена глобально.

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

Рабочий стол Мобильный
Chrome Edge Firefox Internet Explorer Opera Safari WebView Android Chrome Android Firefox for Android Opera Android Safari на IOS Samsung Internet
onUpdated Нет Нет 58 ? Нет Нет ? ? Нет ? Нет ?

Примеры

function handleUpdated(updateInfo) {
  if (updateInfo.theme.colors) {
    console.log(`Theme was applied: ${updateInfo.theme}`);
  } else {
    console.log(`Theme was removed`);
  }
}

browser.theme.onUpdated.addListener(handleUpdated);

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

  • theme-integrated-sidebar

© 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/theme/onUpdated

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API