tabs.highlight()

Hebt einen oder mehrere Tabs hervor (selektiert sie). Tabs werden mithilfe einer Fenster-ID und einer Reihe von Tab-Indizes spezifiziert.

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. Standardmäßig 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 Auffüllen des Fensters (das Standardverhalten) kann ein aufwändiger Vorgang sein, wenn viele Tabs geöffnet sind. Für eine bessere Leistung wird empfohlen, populate manuell auf false zu setzen, wenn keine Tab-Details benötigt werden.

tabs

array von ganzen Zahlen, die einen oder mehrere Tab-Indizes spezifizieren, 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 Promise mit einer Fehlermeldung abgelehnt.

Browser-Kompatibilität

BCD tables only load in the browser

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