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
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 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
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.