bookmarks.move()

Die Methode bookmarks.move() verschiebt den angegebenen BookmarkTreeNode an das angegebene Ziel innerhalb des Lesezeichenbaums. Dies ermöglicht es Ihnen, ein Lesezeichen in einen neuen Ordner und/oder an eine neue Position innerhalb des Ordners zu verschieben.

Warnung: Wenn Ihre Erweiterung versucht, ein Lesezeichen in den Stammknoten der Lesezeichen zu verschieben, wird ein Fehler mit der Meldung "The bookmark root cannot be modified" ausgelöst, und die Verschiebung wird nicht abgeschlossen.

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

Syntax

js
let movingBookmark = browser.bookmarks.move(
  id,                    // string
  destination           // object
)

Parameter

id

Ein string, das die ID des zu verschiebenden Lesezeichens oder Ordners enthält.

destination

Ein object, das das Ziel für das Lesezeichen angibt. Dieses Objekt muss eines oder beide der folgenden Felder enthalten:

parentId Optional

Ein string, das die ID des Zielordners angibt. Wenn dieser Wert weggelassen wird, wird das Lesezeichen an eine neue Position innerhalb seines aktuellen Ordners verschoben.

index Optional

Ein 0-basierter Index, der die Position innerhalb des Ordners angibt, an die das Lesezeichen verschoben werden soll. Ein Wert von 0 verschiebt das Lesezeichen an den Anfang des Ordners. Wenn dieser Wert ausgelassen wird, wird das Lesezeichen am Ende des neuen Zielordners platziert.

Rückgabewert

Ein Promise, das mit einem einzelnen bookmarks.BookmarkTreeNode-Objekt erfüllt wird, das den verschobenen Knoten beschreibt.

Wenn der Knoten, der dem id-Parameter entspricht, nicht gefunden werden kann, wird das Promise mit einer Fehlermeldung abgelehnt.

Hinweis: Wenn Sie mehrere Lesezeichen verschieben, kann diese API aufgrund ihrer Asynchronität die Verschiebeaufrufe in beliebiger Reihenfolge verarbeiten. Folglich kann sich der Indexwert jedes Lesezeichens, der in BookmarkTreeNode zurückgegeben wird, ändern oder unbekannt bleiben, bis alle Verschiebeaufrufe abgeschlossen sind. Wenn der Index, der mit einem Lesezeichen verbunden ist, für Ihre Erweiterung wichtig ist, sollte die Erweiterung – beim Verschieben mehrerer Lesezeichen – warten, bis jeder bookmarks.move-Aufruf abgeschlossen ist, bevor das nächste Lesezeichen verschoben wird. Durch Warten wird sichergestellt, dass der Index, der mit jedem Lesezeichen verbunden ist, nicht durch einen gleichzeitig ausgeführten Verschiebeaufruf beeinflusst wird, während der ursprüngliche Aufruf noch läuft.

Beispiele

Dieses Beispiel verschiebt ein Lesezeichen so, dass es das erste Lesezeichen in seinem aktuellen Ordner ist.

js
function onMoved(bookmarkItem) {
  console.log(bookmarkItem.index);
}

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

let bookmarkId = "abcdefghijkl";

let movingBookmark = browser.bookmarks.move(bookmarkId, { index: 0 });
movingBookmark.then(onMoved, onRejected);

Browser-Kompatibilität

BCD tables only load in the browser

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