BrowserSetting.onChange
Событие BrowserSetting.onChange срабатывает при изменении настройки.
В Firefox оно не срабатывает, если изменение было произведено через about:config.
Синтаксис
BrowserSetting.onChange.addListener(listener) BrowserSetting.onChange.removeListener(listener) BrowserSetting.onChange.hasListener(listener)
События имеют три функции:
addListener(listener)-
Добавляет обработчик к этому событию.
removeListener(listener)-
Прекращает прослушивание этого события. Аргумент
listener— это обработчик, который нужно удалить. hasListener(listener)-
Проверяет, зарегистрирован ли обработчик
listenerдля этого события. Возвращаетtrue, если обработчик зарегистрирован, иfalse, в противном случае.
Синтаксис addListener
Параметры
callback-
Функция обратного вызова, которая будет вызвана при возникновении этого события. Функции будут переданы следующие аргументы:
details-
Объект
object, содержащий детали произошедшего изменения. Его свойства следующие:value-
Новое значение настройки. Тип этого свойства определяется конкретной настройкой.
levelOfControl-
string. Это отражает способ текущего управления настройкой. Вы можете использовать его для проверки возможности изменения настройки. Подробности см. вBrowserSetting.set(). Его значение может быть любым из следующих:"not_controllable"Расширениям запрещено изменять эту настройку. "controlled_by_other_extensions"Другое расширение, установленное после этого, изменило эту настройку. "controllable_by_this_extension"Это расширение разрешено изменять настройку. controlled_by_this_extension"Это расширение уже изменило настройку.
Совместимость с браузерами
| Рабочий стол | Мобильные устройства | |||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
| Chrome | Edge | Firefox | Internet Explorer | Opera | Safari | WebView Android | Chrome Android | Firefox для Android | Opera Android | Safari на iOS | Samsung Internet | |
onChange |
Да | 79 | 72 | ? | Да | Нет | ? | ? | Нет | ? | Нет | ? |
Примеры
Примечание: Этот API основан на API Chromium chrome.types.
© 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/types/BrowserSetting/onChange