bookmarks.onMoved

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, da diese API asynchron ist, die Verarbeitung der Verschiebe-Aufrufe in beliebiger Reihenfolge erfolgen. Folglich kann sich der Wert des Indexes jedes Lesezeichens ändern oder unbekannt sein, bis alle Verschiebe-Aufrufe abgeschlossen sind. Wenn der Index, der einem Lesezeichen zugeordnet ist, für Ihre Erweiterung von Bedeutung ist, sollte die Erweiterung beim Verschieben mehrerer Lesezeichen warten, bis jeder bookmarks.move Aufruf abgeschlossen ist, bevor das nächste Lesezeichen verschoben wird. Warten stellt sicher, dass der Index, der jedem Lesezeichen zugeordnet ist, nicht durch einen Verschiebe-Aufruf beeinflusst wird, der parallel ausgeführt wird, während der ursprüngliche Aufruf noch läuft.

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 zuhört, 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. Siehe den Abschnitt moveInfo für weitere Details.

Zusätzliche Objekte

moveInfo

parentId

string. Der neue übergeordnete Ordner.

index

integer. Der neue Index dieses Elements im übergeordneten Ordner.

oldParentId

string. Der alte übergeordnete Ordner.

oldIndex

integer. Der alte Index des Elements im übergeordneten Ordner.

Browser-Kompatibilität

BCD tables only load in the browser

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 der chrome.bookmarks API von Chromium. Diese Dokumentation stammt aus bookmarks.json im Chromium-Code.