bookmarks.create()

Erstellt ein Lesezeichen oder einen Ordner als Kind des BookmarkTreeNode mit der angegebenen parentId. Um einen Ordner zu erstellen, lassen Sie den Parameter CreateDetails.url weg oder leer.

Warnung: Wenn Ihre Erweiterung versucht, ein neues Lesezeichen im Stammknoten der Lesezeichenstruktur zu erstellen, wird ein Fehler ausgelöst: "Der Lesezeichen-Stamm kann nicht verändert werden" und das Lesezeichen wird nicht erstellt.

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

Syntax

js
let createBookmark = browser.bookmarks.create(
  bookmark                  // CreateDetails object
)

Parameter

bookmark

Ein bookmarks.CreateDetails-Objekt.

Rückgabewert

Ein Promise, das mit einem BookmarkTreeNode erfüllt wird, der den neuen Lesezeichenknoten beschreibt.

Hinweis: Wenn Sie mehrere Lesezeichen erstellen, da diese API asynchron ist, können die Erstellungsaufrufe in beliebiger Reihenfolge verarbeitet werden. Folglich kann sich der Wert jedes Lesezeichen-Indexes in BookmarkTreeNode ändern oder unbekannt sein, bis alle Erstellungsaufrufe abgeschlossen sind. Wenn der Index, der einem Lesezeichen zugeordnet ist, für Ihre Erweiterung wichtig ist, dann sollte die Erweiterung beim Erstellen mehrerer Lesezeichen warten, bis jeder bookmarks.create-Aufruf abgeschlossen ist, bevor das nächste Lesezeichen erstellt wird. Das Warten stellt sicher, dass der mit jedem Lesezeichen assoziierte Index nicht durch einen gleichzeitig ausgeführten Erstellungsaufruf beeinflusst wird, während der ursprüngliche Aufruf noch in Bearbeitung ist.

Beispiele

Dieses Beispiel erstellt ein Lesezeichen für diese Seite, das im Standardordner platziert wird ("Andere Lesezeichen" in Firefox und Chrome).

js
function onCreated(node) {
  console.log(node);
}

let createBookmark = browser.bookmarks.create({
  title: "bookmarks.create() on MDN",
  url: "https://developer.mozilla.org/Add-ons/WebExtensions/API/bookmarks/create",
});

createBookmark.then(onCreated);

Beispiel-Erweiterungen

Browser-Kompatibilität

BCD tables only load in the browser

Hinweis: Diese API basiert auf der chrome.bookmarks-API von Chromium. Diese Dokumentation ist abgeleitet von bookmarks.json im Chromium-Code.