tabs

Interagieren Sie mit dem Tab-System des Browsers.

Hinweis: Bei der Verwendung von Manifest V3 oder höher werden die Methoden zur Skriptausführung, Einfügen von CSS und Entfernen von CSS durch die scripting API über die Methoden scripting.executeScript(), scripting.insertCSS() und scripting.removeCSS() bereitgestellt.

Sie können diese API verwenden, um eine Liste geöffneter Tabs zu erhalten, die nach verschiedenen Kriterien gefiltert ist, sowie um Tabs zu öffnen, zu aktualisieren, zu verschieben, neu zu laden und zu entfernen. Sie können mit dieser API nicht direkt auf die von Tabs gehosteten Inhalte zugreifen, aber Sie können JavaScript und CSS in Tabs mit den APIs tabs.executeScript() oder tabs.insertCSS() einfügen.

Sie können den Großteil dieser API ohne spezielle Berechtigung verwenden. Allerdings:

  • Um auf Tab.url, Tab.title und Tab.favIconUrl zuzugreifen (oder um nach diesen Eigenschaften über tabs.query() zu filtern), müssen Sie die "tabs" Berechtigung besitzen oder Host-Berechtigungen haben, die mit Tab.url übereinstimmen.

    • Der Zugriff auf diese Eigenschaften durch Host-Berechtigungen wird seit Firefox 86 und Chrome 50 unterstützt. In Firefox 85 und früher war stattdessen die "tabs"-Berechtigung erforderlich.
  • Um tabs.executeScript() oder tabs.insertCSS() zu verwenden, müssen Sie die Host-Berechtigung für den Tab besitzen.

Alternativ können Sie diese Berechtigungen vorübergehend nur für den aktuell aktiven Tab und nur als Reaktion auf eine explizite Benutzeraktion erhalten, indem Sie die "activeTab"-Berechtigung anfordern.

Viele Tab-Operationen verwenden eine Tab-id. Tab-ids sind innerhalb einer Browsersitzung garantiert einzigartig für einen einzigen Tab. Wenn der Browser neu gestartet wird, kann und wird er Tab-ids wiederverwenden. Um Informationen mit einem Tab über Browserneustarts hinweg zu verknüpfen, verwenden Sie sessions.setTabValue().

Typen

tabs.MutedInfoReason

Gibt den Grund an, warum ein Tab stummgeschaltet oder die Stummschaltung aufgehoben wurde.

tabs.MutedInfo

Dieses Objekt enthält ein Boolean, das angibt, ob der Tab stummgeschaltet ist, und den Grund für die letzte Statusänderung.

tabs.PageSettings

Wird verwendet, um zu steuern, wie ein Tab als PDF durch die Methode tabs.saveAsPDF() gerendert wird.

tabs.Tab

Dieser Typ enthält Informationen über einen Tab.

tabs.TabStatus

Gibt an, ob das Laden des Tabs abgeschlossen ist.

tabs.WindowType

Der Fenstertyp, der diesen Tab hostet.

tabs.ZoomSettingsMode

Definiert, ob Zoomänderungen vom Browser, von der Erweiterung oder deaktiviert sind.

tabs.ZoomSettingsScope

Definiert, ob Zoomänderungen für den Ursprung der Seite bestehen bleiben oder nur in diesem Tab wirksam werden.

tabs.ZoomSettings

Definiert Zoom-Einstellungen mode, scope, und den Standard-Zoomfaktor.

Eigenschaften

tabs.TAB_ID_NONE

Ein spezieller ID-Wert, der Tabs gegeben wird, die keine Browser-Tabs sind (zum Beispiel Tabs in DevTools-Fenstern).

Funktionen

Ereignisse

tabs.onActivated

Wird ausgelöst, wenn sich der aktive Tab in einem Fenster ändert. Beachten Sie, dass die URL des Tabs möglicherweise nicht festgelegt ist, wenn dieses Ereignis ausgelöst wird.

tabs.onActiveChanged Veraltet

Wird ausgelöst, wenn sich der ausgewählte Tab in einem Fenster ändert. Veraltet: Verwenden Sie stattdessen tabs.onActivated.

tabs.onAttached

Wird ausgelöst, wenn ein Tab an ein Fenster angehängt wird, zum Beispiel weil es zwischen Fenstern verschoben wurde.

tabs.onCreated

Wird ausgelöst, wenn ein Tab erstellt wird. Beachten Sie, dass die URL des Tabs möglicherweise nicht festgelegt ist, wenn dieses Ereignis ausgelöst wird.

tabs.onDetached

Wird ausgelöst, wenn ein Tab von einem Fenster gelöst wird, zum Beispiel weil es zwischen Fenstern verschoben wird.

tabs.onHighlightChanged Veraltet

Wird ausgelöst, wenn sich die hervorgehobenen oder ausgewählten Tabs in einem Fenster ändern. Veraltet: Verwenden Sie stattdessen tabs.onHighlighted.

tabs.onHighlighted

Wird ausgelöst, wenn sich die hervorgehobenen oder ausgewählten Tabs in einem Fenster ändern.

tabs.onMoved

Wird ausgelöst, wenn ein Tab innerhalb eines Fensters verschoben wird.

tabs.onRemoved

Wird ausgelöst, wenn ein Tab geschlossen wird.

tabs.onReplaced

Wird ausgelöst, wenn ein Tab durch einen anderen Tab aufgrund von Prerendering ersetzt wird.

tabs.onSelectionChanged Veraltet

Wird ausgelöst, wenn sich der ausgewählte Tab in einem Fenster ändert. Veraltet: Verwenden Sie stattdessen tabs.onActivated.

tabs.onUpdated

Wird ausgelöst, wenn ein Tab aktualisiert wird.

tabs.onZoomChange

Wird ausgelöst, wenn ein Tab gezoomt wird.

Browser-Kompatibilität

Beispielerweiterungen