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.OnChangedCaused'écrasement. - Ensuite, un nouveau cookie est écrit avec les valeurs mises à jour, généralement une seconde notification avec un
cookies.OnChangedCauseexplicite.
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
trues'il écoute,falsesinon.
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
objetcontenant les détails de la modification survenue. Ses propriétés sont les suivantes :removed-
Un
booléendéfini surtruesi un cookie a été supprimé et sinon false. -
Un objet
cookies.Cookiecontenant les informations sur le cookie qui a été défini ou supprimé. cause-
Une valeur
cookies.OnChangedCausereprésentant la raison sous-jacente de la modification du cookie.
Compatibilité des navigateurs
Chargement…
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,
);
});
Exemples d'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.