tabs.highlight()

Hebt (markiert) einen oder mehrere Tabs hervor. 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. 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 eine aufwändige Operation sein, wenn viele Tabs geöffnet sind. Für eine bessere Leistung wird empfohlen, populate manuell auf false zu setzen, wenn Sie keine Tab-Details benötigen.

tabs

array von Integer-Werten, die einen oder mehrere Tab-Indizes angeben, die hervorgehoben werden sollen. Zuvor hervorgehobene Tabs, die nicht in tabs enthalten sind, werden nicht länger 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. Falls das Fenster nicht gefunden werden kann oder ein anderer Fehler auftritt, wird das Promise mit einer Fehlermeldung zurückgewiesen.

Browser-Kompatibilität

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