tabGroups.onMoved
Wird ausgelöst, wenn eine Tab-Gruppe innerhalb eines Fensters oder in ein anderes Fenster verschoben wird. tabs.onMoved wird auch für die Tabs innerhalb der Gruppe ausgelöst.
Dem Ereignis wird ein tabGroups.TabGroup-Objekt übergeben. Dieses beinhaltet 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 aus.
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 (was tabGroups.onRemoved und tabGroups.onCreated auslö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)-
Hört auf, dieses Ereignis zu überwachen. Das
listener-Argument ist der zu entfernende Listener. hasListener(listener)-
Überprüft, ob
listenerfür dieses Ereignis registriert ist. Gibttruezurück, wenn er zuhört, andernfallsfalse.
addListener Syntax
Parameter
listener-
Die Funktion, die aufgerufen wird, wenn dieses Ereignis auftritt. Der Funktion wird dieses Argument übergeben:
group-
tabGroups.TabGroup. Details zum Zustand der verschobenen Tab-Gruppe.
Beispiele
Tab-Gruppenbewegungen überwachen und protokollieren:
function tabGroupMoved(group) {
console.log(
`Tab group with ID ${group.id} was moved to window ${group.windowId}.`,
);
}
browser.tabGroups.onMoved.addListener(tabGroupMoved);
Eine Tab-Gruppe finden, die in ein anderes Fenster verschoben wurde.
browser.tabGroups.onMoved.addListener(group => {
let tabs = await browser.tabs.query({
groupId: group.id,
});
console.log(`Moved tab group to ${tabs[0].index} in window ${group.windowId}`);
});
Browser-Kompatibilität
Loading…