Dieser Inhalt wurde automatisch aus dem Englischen übersetzt, und kann Fehler enthalten. Erfahre mehr über dieses Experiment.

View in English Always switch to English

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 der Hervorhebung mehrerer Tabs nicht kannte, weshalb dieses Ereignis lediglich 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 Abhören dieses Ereignisses. 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, andernfalls false.

addListener-Syntax

Parameter

listener

Die Funktion, die ausgeführt 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

Abhören von Hervorhebungsereignissen und Protokollierung der IDs hervorgehobener Tabs:

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

browser.tabs.onHighlighted.addListener(handleHighlighted);

Browser-Kompatibilität

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