bookmarks.onChanged
Ausgelöst, wenn es eine Änderung gibt an:
- dem Titel oder der URL eines Lesezeichens
- dem Namen eines Ordners.
Syntax
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. Gibttrue
zurück, wenn zugehört wird, andernfallsfalse
.
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, undurl
, ein String, der die URL des Elements enthält. Wenn das Element ein Ordner ist, wirdurl
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
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.