tabs.onMoved

Wird ausgelöst, wenn ein Tab innerhalb eines Fensters verschoben wird.

Es wird nur ein Verschiebungsereignis ausgelöst, das den Tab darstellt, den der Benutzer direkt verschoben hat. Verschiebungsereignisse werden nicht für die anderen Tabs ausgelöst, die daraufhin verschoben werden müssen. Dieses Ereignis wird nicht ausgelöst, wenn ein Tab zwischen Fenstern verschoben wird. Siehe dafür tabs.onDetached.

Syntax

js
browser.tabs.onMoved.addListener(listener)
browser.tabs.onMoved.removeListener(listener)
browser.tabs.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 Argument listener 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, false andernfalls.

addListener-Syntax

Parameter

listener

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

tabId

integer. ID des Tabs, den der Benutzer verschoben hat.

moveInfo

object. Informationen über die Verschiebung. Siehe den moveInfo-Abschnitt für weitere Details.

Zusätzliche Objekte

moveInfo

windowId

integer. ID des Fensters dieses Tabs.

fromIndex

integer. Ursprünglicher Index dieses Tabs im Fenster.

toIndex

integer. Endgültiger Index dieses Tabs im Fenster.

Beispiele

Hören Sie auf und protokollieren Sie Verschiebungsereignisse:

js
function handleMoved(tabId, moveInfo) {
  console.log(
    `Tab ${tabId} moved from ${moveInfo.fromIndex} to ${moveInfo.toIndex}`,
  );
}

browser.tabs.onMoved.addListener(handleMoved);

Beispielerweiterungen

Browser-Kompatibilität

Hinweis: Diese API basiert auf der chrome.tabs-API von Chromium. Diese Dokumentation leitet sich aus tabs.json im Chromium-Code ab.