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);
Примеры расширений
© 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