--- title: bookmarks.onChanged slug: Mozilla/Add-ons/WebExtensions/API/bookmarks/onChanged tags: - API - Add-ons - Bookmarks - Event - Extensions - Non-standard - Reference - WebExtensions - onChanged translation_of: Mozilla/Add-ons/WebExtensions/API/bookmarks/onChanged ---
{{AddonSidebar}}

Mise en place quand il y a un changement à :

Syntaxe

browser.bookmarks.onChanged.addListener(listener)
browser.bookmarks.onChanged.removeListener(listener)
browser.bookmarks.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. Renvoie true s'il écoute, sinon false.

Syntaxe addListener

Paramètres

callback

Fonction qui sera appelée lorsque cet événement se produit. La fonction recevra les arguments suivants :

id
string. ID de l'article qui a changé.
changeInfo
object. Objet contenant deux propriétés : title, une chaîne contenant le titre de l'élément et url, une chaîne contenant l'URL de l'élément. Si l'élément est un dossier, l'url est omise.

Plusieurs événements peuvent se produire lorsqu'un signet change, et cet objet changeInfo peut contenir uniquement les données qui ont changé, plutôt que toutes les données du signet. En d'autres termes, si l'url d'un signet change, le changeInfo ne peut contenir que les nouvelles informations de l'url.

Exemples

function handleChanged(id, changeInfo) {
  console.log("Item: " + id + " changed");
  console.log("Title: " + changeInfo.title);
  console.log("Url: " + changeInfo.url);
}

function handleClick() {
  browser.bookmarks.onChanged.addListener(handleChanged);
}

browser.browserAction.onClicked.addListener(handleClick);

{{WebExtExamples}}

Compatibilité du navigateur

{{Compat("webextensions.api.bookmarks.onChanged")}}

Remerciements :

Cette API est basée sur l'API Chromium chrome.bookmarks. Cette documentation provient de  bookmarks.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.