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 :

  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 cookie est écrit avec les valeurs mises à jour, généralement une seconde notification avec un cookies.OnChangedCause explicite.

Syntaxe

js
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.

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 :

js
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.