bookmarks.removeTree()
Die Methode bookmarks.removeTree() entfernt rekursiv einen Lesezeichen-Ordner und dessen gesamten Inhalt.
Warnung: Wenn Ihre Erweiterung versucht, einen Lesezeichen-Baumknoten vom Stammknoten des Lesezeichenbaums zu entfernen, wird ein Fehler mit der Nachricht: "Der Lesezeichen-Stamm kann nicht geändert werden" ausgelöst 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
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 sucht einen Lesezeichen-Ordner namens "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 wurde von bookmarks.json im Chromium-Code abgeleitet.