tabGroups.onMoved
Wird ausgelöst, wenn eine Tab-Gruppe innerhalb eines Fensters oder zu einem anderen Fenster verschoben wird. tabs.onMoved wird ebenfalls für die Tabs innerhalb der Gruppe ausgelöst.
Das Ereignis erhält ein tabGroups.TabGroup-Objekt. Dieses enthält die windowId, jedoch nicht die Position der Tab-Gruppe. Um die Position der Tab-Gruppe zu bestimmen, verwenden Sie tabs.query() mit der groupId und lesen Sie die index-Eigenschaft des zurückgegebenen Tabs.
In Chrome wird dieses Ereignis nicht ausgelöst, wenn eine Tab-Gruppe zwischen Fenstern verschoben wird; stattdessen wird die Gruppe aus einem Fenster entfernt und in einem anderen erstellt (dabei werden tabGroups.onRemoved und tabGroups.onCreated ausgelöst).
Syntax
browser.tabGroups.onMoved.addListener(listener)
browser.tabGroups.onMoved.removeListener(listener)
browser.tabGroups.onMoved.hasListener(listener)
Ereignisse haben drei Funktionen:
addListener(listener)-
Fügt diesem Ereignis einen Listener hinzu.
removeListener(listener)-
Beendet das Lauschen auf dieses Ereignis. Das Argument
listenerist der zu entfernende Listener. hasListener(listener)-
Überprüft, ob
listenerfür dieses Ereignis registriert ist. Gibttruezurück, wenn darauf gehört wird, andernfallsfalse.
addListener-Syntax
Parameter
listener-
Die Funktion, die aufgerufen wird, wenn dieses Ereignis eintritt. Der Funktion wird dieses Argument übergeben:
group-
tabGroups.TabGroup. Details zum Zustand der verschobenen Tab-Gruppe.
Beispiele
Lauschen und Protokollieren der Bewegung von Tab-Gruppen:
function tabGroupMoved(group) {
console.log(
`Tab group with ID ${group.id} was moved to window ${group.windowId}.`,
);
}
browser.tabGroups.onMoved.addListener(tabGroupMoved);
Lokalisieren einer Tab-Gruppe, die in ein anderes Fenster verschoben wurde.
browser.tabGroups.onMoved.addListener(async (group) => {
let tabs = await browser.tabs.query({
groupId: group.id,
});
console.log(
`Moved tab group to ${tabs[0].index} in window ${group.windowId}`,
);
});