tabs.onHighlighted

Wird ausgelöst, wenn sich die Gruppe der hervorgehobenen Tabs in einem Fenster ändert.

Beachten Sie, dass Firefox vor Version 63 das Konzept des Hervorhebens mehrerer Tabs nicht hatte, sodass dieses Ereignis lediglich ein Alias für tabs.onActivated war.

Syntax

browser.tabs.onHighlighted.addListener(listener)
browser.tabs.onHighlighted.removeListener(listener)
browser.tabs.onHighlighted.hasListener(listener)

Ereignisse haben drei Funktionen:

addListener(listener): Fügt diesem Ereignis einen Listener hinzu.
removeListener(listener): Hört auf, auf dieses Ereignis zu hören. Das Argument listener ist der zu entfernende Listener.
hasListener(listener): Prüft, ob listener für dieses Ereignis registriert ist. Gibt true zurück, wenn darauf gehört wird, false sonst.

addListener-Syntax

Parameter

listener

Die Funktion, die aufgerufen wird, wenn dieses Ereignis eintritt. Der Funktion wird dieses Argument übergeben:

highlightInfo: object. ID(s) der hervorgehobenen Tabs und ID ihres Fensters. Siehe den Abschnitt highlightInfo für weitere Details.

Zusätzliche Objekte

highlightInfo

windowId: integer. ID des Fensters, dessen Tabs sich geändert haben.
tabIds: array von integer. IDs der hervorgehobenen Tabs im Fenster.

Beispiele

Auf Hervorhebungsereignisse hören und die IDs der hervorgehobenen Tabs protokollieren:

function handleHighlighted(highlightInfo) {
  console.log(`Highlighted tabs: ${highlightInfo.tabIds}`);
}

browser.tabs.onHighlighted.addListener(handleHighlighted);

Browser-Kompatibilität

BCD tables only load in the browser

Hinweis: Diese API basiert auf der chrome.tabs-API von Chromium. Diese Dokumentation ist abgeleitet von tabs.json im Chromium-Code.