storage.StorageArea.onChanged

Срабатывает при изменении одного или нескольких элементов в области хранения. По сравнению с storage.onChanged, это событие позволяет прослушивать изменения в одной из областей хранения: local, managed, session, и sync.

Синтаксис

// local can also be sync, managed, or session
browser.storage.local.onChanged.addListener(callback)
browser.storage.local.onChanged.removeListener(listener)
browser.storage.local.onChanged.hasListener(listener)

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

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

Синтаксис addListener

Параметры

callback

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

changes: object. Объект, описывающий изменение. Он содержит по одному свойству для каждого изменённого ключа. Название свойства — это название изменённого ключа, а значение — объект storage.StorageChange, описывающий изменения этого элемента.

Примеры

/*
Log the old value and its new value of
changes in the local storage.
*/
function logStorageChange(changes) {

  const changedItems = Object.keys(changes);

  for (const item of changedItems) {
    console.log(`${item} has changed:`);
    console.log("Old value: ", changes[item].oldValue);
    console.log("New value: ", changes[item].newValue);
  }
}

browser.storage.local.onChanged.addListener(logStorageChange);

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

	Рабочий стол						Мобильные устройства
	Chrome	Edge	Firefox	Internet Explorer	Opera	Safari	WebView Android	Chrome Android	Firefox for Android	Opera Android	Safari на IOS	Samsung Internet
`onChanged`	73	Да	101	?	Да	14	?	?	101	?	15	?

Примечание: Этот API основан на API chrome.storage Chromium. Данная документация получена из storage.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/storage/StorageArea/onChanged