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

js
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 ist true. Wenn auf false gesetzt, wird das windows.Window-Objekt keine tabs-Eigenschaft haben, die eine Liste von tabs.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 auf false 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 in tabs enthalten sind, werden nicht mehr hervorgehoben. Der erste Tab in tabs 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.