cookies.onChanged
L'événement onChanged
de l'API cookies
est déclenché lorsqu'un cookie est défini ou supprimé.
Notez que la mise à jour des propriétés d'un cookie est implémentée en deux étapes :
- Tout d'abord, le cookie à mettre à jour est tout d'abord entiérement supprimé, généralement une notification avec un
cookies.OnChangedCause
d'écrasement. - Ensuite, un nouveau cookie est écrit avec les valeurs mises à jour, généralement une seconde notification avec un
cookies.OnChangedCause
explicite
.
Syntaxe
browser.cookies.onChanged.addListener(listener);
browser.cookies.onChanged.removeListener(listener);
browser.cookies.onChanged.hasListener(listener);
Cet API est également disponible en tant que browser.cookies.onChanged.*
.
Les événements ont trois fonctions :
addListener(callback)
-
Ajoute un écouteur à l'événement.
removeListener(listener)
-
Arrêtez d'écouter cet événement. L'argument de l'écouteur à supprimer.
hasListener(listener)
-
Vérifiez si l'écouteur est enregistré pour cet événement. Retourne
true
s'il écoute,false
sinon.
Syntaxe addListener
Paramètres
callback
-
Une fonction de rappel qui sera appelée lorsque l'événement se produira. La fonction recevra les arguments suivants :
changeInfo
-
Un
objet
contenant les détails de la modification survenue. Ses propriétés sont les suivantes :removed
-
Un
booléen
défini surtrue
si un cookie a été supprimé et sinon false. -
Un objet
cookies.Cookie
contenant les informations sur le cookie qui a été défini ou supprimé. cause
-
Une valeur
cookies.OnChangedCause
représentant la raison sous-jacente de la modification du cookie.
Compatibilité des navigateurs
BCD tables only load in the browser
Exemples
Cet exemple écoute les événements onChanged
et enregistre les détails de l'argument changeInfo
:
browser.cookies.onChanged.addListener(function (changeInfo) {
console.log(
"Cookie changed: " +
"\n * Cookie: " +
JSON.stringify(changeInfo.cookie) +
"\n * Cause: " +
changeInfo.cause +
"\n * Removed: " +
changeInfo.removed,
);
});
Example extensions
Note :
Cette API est basée sur l'API Chromium chrome.cookies
. Cette documentation est dérivée de cookies.json
dans le code 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.