bookmarks.onChanged

Ausgelöst, wenn es eine Änderung gibt an:

  • dem Titel oder der URL eines Lesezeichens
  • dem Namen eines Ordners.

Syntax

js
browser.bookmarks.onChanged.addListener(listener)
browser.bookmarks.onChanged.removeListener(listener)
browser.bookmarks.onChanged.hasListener(listener)

Ereignisse haben drei Funktionen:

addListener(listener)

Fügt diesem Ereignis einen Listener hinzu.

removeListener(listener)

Stoppt das Zuhören auf dieses Ereignis. Das Argument listener ist der zu entfernende Listener.

hasListener(listener)

Prüfen, ob listener für dieses Ereignis registriert ist. Gibt true zurück, wenn zugehört wird, andernfalls false.

addListener-Syntax

Parameter

listener

Die Funktion, die aufgerufen wird, wenn dieses Ereignis eintritt. Der Funktion werden folgende Argumente übergeben:

id

string. ID des geänderten Elements.

changeInfo

object. Objekt mit zwei Eigenschaften: title, ein String, der den Titel des Elements enthält, und url, ein String, der die URL des Elements enthält. Wenn das Element ein Ordner ist, wird url weggelassen.

Hinweis: Mehrere Ereignisse können auftreten, wenn sich ein Lesezeichen ändert, und das changeInfo-Objekt kann nur die geänderten Daten enthalten, anstatt aller Daten für das Lesezeichen. Anders gesagt, wenn sich die url eines Lesezeichens ändert, kann das changeInfo nur die neue url-Information enthalten.

Beispiele

js
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);

Browser-Kompatibilität

Hinweis: Diese API basiert auf der chrome.bookmarks API von Chromium. Diese Dokumentation ist abgeleitet von bookmarks.json im Chromium-Code.