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 lassen Sie ihn leer.

Warnung: Wenn Ihre Erweiterung versucht, ein neues Lesezeichen im Stammknoten des Lesezeichenbaums zu erstellen, wird ein Fehler ausgegeben: "The bookmark root cannot be modified" 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, das den neuen Lesezeichenknoten beschreibt.

Hinweis: Wenn Sie mehrere Lesezeichen erstellen, kann aufgrund dieser asynchronen API die Reihenfolge der Erstellung variieren. Folglich kann der Wert des Indexes jedes Lesezeichens, der in BookmarkTreeNode zurückgegeben wird, sich ändern oder unbekannt sein, bis alle Erstellungsaufrufe abgeschlossen sind. Wenn der Index eines Lesezeichens für Ihre Erweiterung wichtig ist, sollte die Erweiterung bei der Erstellung mehrerer Lesezeichen warten, bis jeder bookmarks.create Aufruf abgeschlossen ist, bevor das nächste Lesezeichen erstellt wird. Das Warten stellt sicher, dass der Index jedes Lesezeichens nicht durch einen gleichzeitig ausgeführten Erstellungsaufruf beeinflusst wird, während der ursprüngliche Aufruf noch ausgeführt wird.

Beispiele

Dieses Beispiel erstellt ein Lesezeichen für diese Seite und platziert es im Standardordner ("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);

Beispielerweiterungen

Browser-Kompatibilität

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