bookmarks.move()
Die bookmarks.move()-Methode verschiebt den angegebenen BookmarkTreeNode zum angegebenen 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 des Lesezeichenbaums zu verschieben, wird ein Fehler mit der Meldung: "The bookmark root cannot be modified" ausgegeben und das Verschieben wird nicht abgeschlossen.
Dies ist eine asynchrone Funktion, die ein Promise zurückgibt.
Syntax
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 spezifiziert. Dieses Objekt muss eines oder beide der folgenden Felder enthalten:parentIdOptional-
Ein
String, das die ID des Zielordners spezifiziert. Wenn dieser Wert weggelassen wird, wird das Lesezeichen an einen neuen Ort innerhalb seines aktuellen Ordners verschoben. indexOptional-
Ein Index, der bei 0 beginnt und die Position innerhalb des Ordners angibt, zu der das Lesezeichen verschoben werden soll. Ein Wert von 0 verschiebt das Lesezeichen an den Anfang des Ordners. Wenn dieser Wert weggelassen 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, da diese API asynchron ist, können die Verschiebeaufrufe in beliebiger Reihenfolge verarbeitet werden. Folglich kann der Indexwert jedes Lesezeichens, der in BookmarkTreeNode zurückgegeben wird, sich ändern oder unbekannt sein, bis alle Verschiebeaufrufe abgeschlossen sind. Wenn der mit einem Lesezeichen verknüpfte Index für Ihre Erweiterung wichtig ist, sollte die Erweiterung – beim Verschieben mehrerer Lesezeichen – darauf warten, dass jeder bookmarks.move-Aufruf abgeschlossen ist, bevor das nächste Lesezeichen verschoben wird. Das Warten stellt sicher, dass der mit jedem Lesezeichen assoziierte Index nicht durch einen gleichzeitig ausgeführten Verschiebeaufruf beeinflusst wird, während der ursprüngliche Aufruf noch in Bearbeitung ist.
Beispiele
Dieses Beispiel verschiebt ein Lesezeichen so, dass es das erste Lesezeichen in seinem aktuellen Ordner ist.
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
Hinweis:
Diese API basiert auf Chromiums chrome.bookmarks API. Diese Dokumentation ist abgeleitet von bookmarks.json im Chromium-Code.