bookmarks.remove()

Die Methode bookmarks.remove() entfernt ein einzelnes Lesezeichen oder einen leeren Lesezeichen-Ordner.

Warnung: Wenn Ihre Erweiterung versucht, ein Lesezeichen aus dem Stammknoten des Lesezeichenbaums zu entfernen, wird ein Fehler mit der Nachricht ausgegeben: "The bookmark root cannot be modified" und das Lesezeichen wird nicht entfernt.

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

Syntax

js
let removingBookmark = browser.bookmarks.remove(
  id                 // string
)

Parameter

id

Ein string, der die ID des zu entfernenden Lesezeichens oder des leeren Ordners angibt.

Rückgabewert

Ein Promise, das ohne Argumente erfüllt wird.

Wenn der Knoten, der dem id-Parameter entspricht, nicht gefunden werden kann oder es sich um einen nicht leeren Ordner handelte, wird das Promise mit einer Fehlermeldung abgelehnt.

Beispiele

js
function onRemoved() {
  console.log("Removed!");
}

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

let bookmarkId = "abcdefghijkl";

let removingBookmark = browser.bookmarks.remove(bookmarkId);
removingBookmark.then(onRemoved, onRejected);

Beispiel-Erweiterungen

Browser-Kompatibilität

BCD tables only load in the browser

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