bookmarks.removeTree()

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

Warnung: Wenn Ihre Erweiterung versucht, einen Lesezeichen-Baum vom Stammknoten des Lesezeichen-Baums zu entfernen, wird ein Fehler mit der Nachricht "The bookmark root cannot be modified" ausgelöst, und das Lesezeichen wird nicht entfernt.

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

Syntax

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

Parameter

id

Ein string, der 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.

js
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

BCD tables only load in the browser

Hinweis: Diese API basiert auf Chromiums chrome.bookmarks API. Diese Dokumentation stammt aus bookmarks.json im Chromium-Code.