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 :

  1. 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.
  2. Ensuite, un nouveau sookie 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 sur true si un cookie a été supprimé et sinon  false.
cookie
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é du navigateur

ChromeEdgeFirefoxFirefox for AndroidOpera
Support simple Oui Non4548 Oui

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

Remerciements :

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.

Étiquettes et contributeurs liés au document

 Contributeurs à cette page : hellosct1
 Dernière mise à jour par : hellosct1,