bookmarks.onMoved

Wird ausgelöst, wenn ein Lesezeichen oder Ordner in einen anderen übergeordneten Ordner oder an eine andere Position innerhalb eines Ordners verschoben wird.

Hinweis: Wenn Sie mehrere Lesezeichen verschieben, kann aufgrund dieser asynchronen API die Reihenfolge der Verschiebungen variieren. Folglich kann der Indexwert jedes Lesezeichens sich ändern oder unbekannt sein, bis alle Verschiebungen abgeschlossen sind. Falls der Index eines Lesezeichens für Ihre Erweiterung wichtig ist, sollte die Erweiterung – beim Verschieben mehrerer Lesezeichen – darauf warten, dass jeder bookmarks.move-Aufruf abgeschlossen wird, bevor das nächste Lesezeichen verschoben wird. Das Warten stellt sicher, dass der Index eines jeden Lesezeichens nicht durch einen gleichzeitigen Verschiebeaufruf beeinflusst wird, während der ursprüngliche Aufruf noch ausgeführt wird.

Syntax

js
browser.bookmarks.onMoved.addListener(listener)
browser.bookmarks.onMoved.removeListener(listener)
browser.bookmarks.onMoved.hasListener(listener)

Ereignisse haben drei Funktionen:

addListener(listener)

Fügt diesem Ereignis einen Listener hinzu.

removeListener(listener)

Stoppt das Lauschen auf dieses Ereignis. Das listener-Argument ist der zu entfernende Listener.

hasListener(listener)

Überprüft, ob listener für dieses Ereignis registriert ist. Gibt true zurück, wenn es lauscht, andernfalls false.

addListener-Syntax

Parameter

listener

Die Funktion, die aufgerufen wird, wenn dieses Ereignis eintritt. Der Funktion werden folgende Argumente übergeben:

id

string. ID des Elements, das verschoben wurde.

moveInfo

object. Objekt mit weiteren Details zur Verschiebung. Weitere Details siehe im Abschnitt moveInfo.

Zusätzliche Objekte

moveInfo

parentId

string. Der neue übergeordnete Ordner.

index

integer. Der neue Index dieses Elements in seinem übergeordneten Ordner.

oldParentId

string. Der alte übergeordnete Ordner.

oldIndex

integer. Der alte Index des Elements in seinem übergeordneten Ordner.

Browser-Kompatibilität

Beispiele

js
function handleMoved(id, moveInfo) {
  console.log(`Item: ${id} moved`);
  console.log(`Old index: ${moveInfo.oldIndex}`);
  console.log(`New index: ${moveInfo.index}`);
  console.log(`Old folder: ${moveInfo.oldParentId}`);
  console.log(`New folder: ${moveInfo.parentId}`);
}

function handleClick() {
  browser.bookmarks.onMoved.addListener(handleMoved);
}

browser.browserAction.onClicked.addListener(handleClick);

Hinweis: Diese API basiert auf Chromiums chrome.bookmarks API. Diese Dokumentation stammt aus bookmarks.json im Chromium-Code.