bookmarks.move()
Die bookmarks.move()-Methode verschiebt den angegebenen BookmarkTreeNode zum angegebenen Ziel innerhalb der Lesezeichenstruktur. Dies ermöglicht das Verschieben eines Lesezeichens in einen neuen Ordner und/oder an eine neue Position innerhalb des Ordners.
Warnung: Wenn Ihre Erweiterung versucht, ein Lesezeichen in den Wurzelknoten der Lesezeichenstruktur zu verschieben, wird ein Fehler mit der Meldung "The bookmark root cannot be modified" auftreten und die Verschiebung 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, der 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:parentIdOptional-
Ein
string, das die ID des Zielordners angibt. Wird dieser Wert weggelassen, wird das Lesezeichen an einen neuen Standort innerhalb seines aktuellen Ordners verschoben. indexOptional-
Ein Index, beginnend bei 0, der die Position innerhalb des Ordners angibt, an die das Lesezeichen verschoben werden soll. Ein Wert von 0 verschiebt das Lesezeichen an die Spitze des Ordners. Wird dieser Wert weggelassen, wird das Lesezeichen am Ende des neuen übergeordneten Ordners platziert.
Rückgabewert
Ein Promise, das mit einem einzelnen bookmarks.BookmarkTreeNode-Objekt erfüllt wird, welches den verschobenen Knoten beschreibt.
Kann der Knoten, der dem id-Parameter entspricht, nicht gefunden werden, 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 sich der zurückgegebene Indexwert jedes Lesezeichens in BookmarkTreeNode ändern oder unbekannt sein, bis alle Verschiebeaufrufe abgeschlossen sind. Wenn der Index, der einem Lesezeichen zugeordnet ist, für Ihre Erweiterung von Bedeutung ist, sollte die Erweiterung, wenn mehrere Lesezeichen verschoben werden, auf den Abschluss jedes bookmarks.move-Aufrufs warten, bevor das nächste Lesezeichen verschoben wird. Das Warten stellt sicher, dass der Index, der jedem Lesezeichen zugeordnet ist, von einem gleichzeitig ausgeführten Verschiebeaufruf nicht beeinflusst wird, während der ursprüngliche Aufruf noch im Gange ist.
Beispiele
Dieses Beispiel verschiebt ein Lesezeichen, sodass 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
Loading…
Hinweis:
Diese API basiert auf der chrome.bookmarks API von Chromium. Diese Dokumentation ist abgeleitet von bookmarks.json im Chromium-Code.