tabs

Interagieren Sie mit dem Tab-System des Browsers.

Hinweis: Bei Verwendung von Manifest V3 oder höher stellt die scripting-API die Methoden zum Ausführen von Skripten, Einfügen von CSS und Entfernen von CSS bereit: scripting.executeScript(), scripting.insertCSS() und scripting.removeCSS().

Mit dieser API können Sie eine nach verschiedenen Kriterien gefilterte Liste geöffneter Tabs abrufen sowie Tabs öffnen, aktualisieren, verschieben, neu laden und entfernen. Sie können mit dieser API nicht direkt auf die Inhalte von Tabs zugreifen. Mit den APIs tabs.executeScript() und tabs.insertCSS() können Sie jedoch JavaScript und CSS in Tabs einfügen.

Den Großteil dieser API können Sie ohne besondere Berechtigung verwenden. Allerdings gilt:

Für den Zugriff auf Tab.url, Tab.title und Tab.favIconUrl sowie zum Filtern nach diesen Eigenschaften mit tabs.query() benötigen Sie die Berechtigung "tabs" oder Host-Berechtigungen, die auf Tab.url zutreffen.
- Der Zugriff auf diese Eigenschaften über Host-Berechtigungen wird seit Firefox 86 und Chrome 50 unterstützt. In Firefox 85 und früher war stattdessen die Berechtigung "tabs" erforderlich.
Für die Verwendung von tabs.executeScript() oder tabs.insertCSS() benötigen Sie die Host-Berechtigung für den Tab.

Alternativ können Sie diese Berechtigungen als Reaktion auf eine ausdrückliche Benutzeraktion vorübergehend für den aktiven Tab erhalten, indem Sie die Berechtigung activeTab anfordern.

Viele Tab-Operationen verwenden eine Tab-id. Die Eindeutigkeit von Tab-ids ist nur innerhalb einer Browsersitzung gewährleistet. Nach einem Neustart kann der Browser Tab-ids erneut verwenden und wird dies auch tun. Um Informationen auch über Browserneustarts hinweg einem Tab zuzuordnen, 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 einen booleschen Wert, der angibt, ob der Tab stummgeschaltet ist, sowie den Grund für die letzte Zustandsänderung.
tabs.PageSettings: Wird verwendet, um zu steuern, wie ein Tab von der Methode tabs.saveAsPDF() als PDF 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 Typ des Fensters, das diesen Tab enthält.
tabs.ZoomSettingsMode: Legt fest, ob Zoomänderungen vom Browser oder von der Erweiterung verarbeitet werden oder deaktiviert sind.
tabs.ZoomSettingsScope: Legt fest, ob Zoomänderungen für die Origin der Seite bestehen bleiben oder nur in diesem Tab wirksam sind.
tabs.ZoomSettings: Definiert die Zoomeinstellungen mode und scope sowie den standardmäßigen Zoomfaktor.

Eigenschaften

tabs.TAB_ID_NONE: Ein spezieller ID-Wert für Tabs, die keine Browser-Tabs sind (beispielsweise Tabs in Entwicklerwerkzeugfenstern).
tabs.SPLIT_VIEW_ID_NONE: Ein spezieller ID-Wert für Tabs, die sich nicht in einer geteilten Ansicht befinden.

Funktionen

tabs.captureTab(): Erstellt eine Daten-URL, die ein Bild des sichtbaren Bereichs des angegebenen Tabs enthält.
tabs.captureVisibleTab(): Erstellt eine Daten-URL, die ein Bild des sichtbaren Bereichs des derzeit aktiven Tabs im angegebenen Fenster enthält.
tabs.connect(): Stellt eine Nachrichtenverbindung zwischen den Hintergrundskripten der Erweiterung (oder anderen privilegierten Skripten wie Popup-Skripten oder Skripten der Optionsseite) und allen Content-Skripten her, die im angegebenen Tab ausgeführt werden.
tabs.create(): Erstellt einen neuen Tab.
tabs.detectLanguage(): Erkennt die Hauptsprache des Inhalts in einem Tab.
tabs.discard(): Verwirft einen oder mehrere Tabs.
tabs.duplicate(): Dupliziert einen Tab.
tabs.executeScript() (nur Manifest V2): Fügt JavaScript-Code in eine Seite ein.
tabs.get(): Ruft Details zum angegebenen Tab ab.
tabs.getAllInWindow(): Ruft Details zu allen Tabs im angegebenen Fenster ab.
tabs.getCurrent(): Ruft Informationen über den Tab ab, in dem dieses Skript ausgeführt wird, und gibt sie als tabs.Tab-Objekt zurück.
tabs.getSelected(): Ruft den im angegebenen Fenster ausgewählten Tab ab. Veraltet: Verwenden Sie stattdessen tabs.query({active: true}).
tabs.getZoom(): Ruft den aktuellen Zoomfaktor des angegebenen Tabs ab.
tabs.getZoomSettings(): Ruft die aktuellen Zoomeinstellungen für den angegebenen Tab ab.
tabs.goForward(): Navigiert zur nächsten Seite, falls eine verfügbar ist.
tabs.goBack(): Navigiert zur vorherigen Seite, falls eine verfügbar ist.
tabs.group(): Fügt Tabs einer Tab-Gruppe hinzu.
tabs.hide(): Blendet einen oder mehrere Tabs aus.
tabs.highlight(): Hebt einen oder mehrere Tabs hervor.
tabs.insertCSS() (nur Manifest V2): Fügt CSS in eine Seite ein.
tabs.move(): Verschiebt einen oder mehrere Tabs an eine neue Position im selben Fenster oder in ein anderes Fenster.
tabs.moveInSuccession(): Ändert die Nachfolgebeziehung für eine Gruppe von Tabs.
tabs.print(): Druckt den Inhalt des aktiven Tabs.
tabs.printPreview(): Öffnet die Druckvorschau für den aktiven Tab.
tabs.query(): Ruft alle Tabs mit den angegebenen Eigenschaften ab oder alle Tabs, wenn keine Eigenschaften angegeben sind.
tabs.reload(): Lädt einen Tab neu, wobei der lokale Webcache optional umgangen werden kann.
tabs.remove(): Schließt einen oder mehrere Tabs.
tabs.removeCSS() (nur Manifest V2): Entfernt CSS von einer Seite, das zuvor durch einen Aufruf von tabs.insertCSS() eingefügt wurde.
tabs.saveAsPDF(): Speichert die aktuelle Seite als PDF.
tabs.sendMessage(): Sendet eine einzelne Nachricht an die Content-Skripte im angegebenen Tab.
tabs.sendRequest(): Sendet eine einzelne Anfrage an die Content-Skripte im angegebenen Tab. Veraltet: Verwenden Sie stattdessen tabs.sendMessage().
tabs.setZoom(): Ändert den Zoomfaktor des angegebenen Tabs.
tabs.setZoomSettings(): Legt die Zoomeinstellungen für den angegebenen Tab fest.
tabs.show(): Zeigt einen oder mehrere Tabs an, die mit hidden ausgeblendet wurden.
tabs.toggleReaderMode(): Schaltet den Lesemodus für den angegebenen Tab ein oder aus.
tabs.ungroup(): Entfernt Tabs aus Tab-Gruppen.
tabs.update(): Navigiert den Tab zu einer neuen URL oder ändert andere Eigenschaften des Tabs.
tabs.warmup(): Bereitet den Tab darauf vor, einen möglichen anschließenden Wechsel zu beschleunigen.

Ereignisse

tabs.onActivated: Wird ausgelöst, wenn sich der aktive Tab in einem Fenster ändert. Beachten Sie, dass die URL des Tabs zum Zeitpunkt der Auslösung dieses Ereignisses möglicherweise noch nicht festgelegt ist.
tabs.onActiveChanged: 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 einem Fenster hinzugefügt wird, beispielsweise weil er zwischen Fenstern verschoben wurde.
tabs.onCreated: Wird ausgelöst, wenn ein Tab erstellt wird. Beachten Sie, dass die URL des Tabs zum Zeitpunkt der Auslösung dieses Ereignisses möglicherweise noch nicht festgelegt ist.
tabs.onDetached: Wird ausgelöst, wenn ein Tab von einem Fenster gelöst wird, beispielsweise weil er zwischen Fenstern verschoben wird.
tabs.onHighlightChanged: 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 aufgrund von Prerendering durch einen anderen Tab ersetzt wird.
tabs.onSelectionChanged: 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 der Zoomfaktor eines Tabs geändert wird.

Beispielerweiterungen

Browser-Kompatibilität

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

Help improve MDN

Erfahren Sie, wie Sie beitragen können Diese Seite wurde automatisch aus dem Englischen übersetzt.

Übersetzung auf GitHub anzeigen • Fehler mit dieser Übersetzung melden