tabs.onHighlighted

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

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

Syntax

js
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)

Stoppt das Lauschen auf dieses Ereignis. Das listener-Argument ist der zu entfernende Listener.

hasListener(listener)

Überprüft, ob der listener für dieses Ereignis registriert ist. Gibt true zurück, wenn er lauscht, andernfalls false.

addListener-Syntax

Parameter

listener

Die Funktion, die aufgerufen wird, wenn dieses Ereignis eintritt. Der Funktion wird folgendes 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

Lauschen Sie auf Markierungsereignisse und protokollieren Sie die IDs der hervorgehobenen Tabs:

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

browser.tabs.onHighlighted.addListener(handleHighlighted);

Browser-Kompatibilität

Hinweis: Diese API basiert auf der Chromium-API chrome.tabs. Diese Dokumentation stammt aus tabs.json im Chromium-Code.