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
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.
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.