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

Report problems with this compatibility data on GitHub
desktopmobile
Chrome
Edge
Firefox
Opera
Safari
Firefox for Android
Safari on iOS
removeTree

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support
No support
No support

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