bookmarks.removeTree()

Die Methode bookmarks.removeTree() entfernt rekursiv einen Lesezeichen-Ordner und dessen gesamten Inhalt.

Warnung: Wenn Ihre Erweiterung versucht, einen Lesezeichen-Baum aus dem Stammknoten des Lesezeichenbaums zu entfernen, wird ein Fehler mit der Nachricht ausgelöst: "Der Lesezeichen-Stamm kann nicht geändert werden", und das Lesezeichen wird nicht entfernt.

Dies ist eine asynchrone Funktion, die ein Promise zurückgibt.

Syntax

let removingTree = browser.bookmarks.removeTree(
  id                // string
)

Parameter

id: Eine string, die die ID des Ordnerknotens angibt, der zusammen mit seinen Nachkommen gelöscht werden soll.

Rückgabewert

Ein Promise, das ohne Argumente erfüllt wird, wenn der Baum entfernt wurde.

Wenn der Knoten, der dem id Parameter entspricht, nicht gefunden werden kann, wird das Promise mit einer Fehlermeldung abgelehnt.

Beispiele

Dieses Beispiel findet einen Lesezeichen-Ordner mit dem Namen "MDN" und löscht ihn zusammen mit seinem gesamten Inhalt.

function onRemoved() {
  console.log("bookmark item removed!");
}

function onRejected(error) {
  console.log(`An error: ${error}`);
}

function removeMDN(searchResults) {
  if (searchResults.length) {
    let removing = browser.bookmarks.removeTree(searchResults[0].id);
    removing.then(onRemoved, onRejected);
  }
}

let searchingBookmarks = browser.bookmarks.search({ title: "MDN" });
searchingBookmarks.then(removeMDN, onRejected);

Browser-Kompatibilität

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