tabs.highlight()
Hebt ein oder mehrere Tabs hervor (wählt sie aus). Tabs werden mit einer Fenster-ID und einem Bereich von Tab-Indizes angegeben.
Dies ist eine asynchrone Funktion, die ein Promise
zurückgibt.
Syntax
let highlighting = browser.tabs.highlight(
highlightInfo // object
)
Parameter
highlightInfo
-
object
.windowId
Optional-
integer
. ID des Fensters, das die Tabs enthält. populate
Optional-
boolean
. Standardwert isttrue
. Wenn auffalse
gesetzt, wird daswindows.Window
-Objekt keinetabs
-Eigenschaft haben, die eine Liste vontabs.Tab
-Objekten enthält, die die im Fenster geöffneten Tabs darstellen.Hinweis: Das Befüllen des Fensters (das Standardverhalten) kann eine kostspielige Operation sein, wenn viele Tabs vorhanden sind. Für eine bessere Performance wird empfohlen,
populate
manuell auffalse
zu setzen, wenn Tab-Details nicht benötigt werden. tabs
-
array
von ganzzahligen Werten, die einen oder mehrere Tab-Indizes angeben, die hervorgehoben werden sollen. Zuvor hervorgehobene Tabs, die nicht intabs
enthalten sind, werden nicht mehr hervorgehoben. Der erste Tab intabs
wird aktiv.
Rückgabewert
Ein Promise
, das mit einem windows.Window
-Objekt erfüllt wird, das Details über das Fenster enthält, dessen Tabs hervorgehoben wurden. Wenn das Fenster nicht gefunden werden konnte oder ein anderer Fehler auftritt, wird das Versprechen mit einer Fehlermeldung abgelehnt.
Browser-Kompatibilität
Hinweis:
Diese API basiert auf Chromiums chrome.tabs
-API. Diese Dokumentation ist abgeleitet von tabs.json
im Chromium-Code.