storage.onChanged
Lancé lorsqu'un ou plusieurs éléments changent.
Syntaxe
browser.storage.onChanged.addListener(callback);
browser.storage.onChanged.removeListener(listener);
browser.storage.onChanged.hasListener(listener);
Les événements ont trois fonctions:
addListener(callback)
-
Ajoute un écouteur à cet événement.
removeListener(listener)
-
Arrêtez d'écouter cet événement. L'argument
listener
est l'écouteur à supprimer. hasListener(listener)
-
Vérifiez si
listener
est enregistré pour cet événement. Renvoietrue
s'il écoute, sinonfalse
.
Syntaxe addListener
Paramètres
callback
-
Fonction qui sera appelée lorsque cet événement se produit. La fonction recevra les arguments suivants :
changes
-
object
. Objet décrivant le changement. Cela contient une propriété pour chaque clé qui a changé. Le nom de la propriété est le nom de la clé qui a changé, et sa valeur est un objetstorage.StorageChange
décrivant la modification apportée à cet élément.
areaName
-
string
. Le nom de la zone de stockage ("sync"
,"local"
or"managed"
) auquel les modifications ont été apportées.
Compatibilité des navigateurs
BCD tables only load in the browser
Exemples
/*
Log the storage area that changed,
then for each item changed,
log its old value and its new value.
*/
function logStorageChange(changes, area) {
console.log("Change in storage area: " + area);
var changedItems = Object.keys(changes);
for (var item of changedItems) {
console.log(item + " has changed:");
console.log("Old value: ");
console.log(changes[item].oldValue);
console.log("New value: ");
console.log(changes[item].newValue);
}
}
browser.storage.onChanged.addListener(logStorageChange);
Example extensions
Note :
Cette API est basée sur l'API Chromium chrome.storage
. Cette documentation est dérivée de storage.json
dans le code de Chromium.
Les données de compatibilité relatives à Microsoft Edge sont fournies par Microsoft Corporation et incluses ici sous la licence Creative Commons Attribution 3.0 pour les États-Unis.