tabs

Interagieren Sie mit dem Tabsystem des Browsers.

Hinweis:Wenn Sie Manifest V3 oder höher verwenden, werden die Methoden zum Ausführen von Skripten, Einfügen von CSS und Entfernen von CSS durch diescripting API über die Methodenscripting.executeScript(),scripting.insertCSS() undscripting.removeCSS() bereitgestellt.

Sie können diese API verwenden, um eine Liste geöffneter Tabs zu erhalten, gefiltert nach verschiedenen Kriterien, und 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 APIstabs.executeScript() odertabs.insertCSS() einfügen.

Sie können den Großteil dieser API ohne besondere Berechtigung nutzen. Allerdings:

Um aufTab.url,Tab.title undTab.favIconUrl zuzugreifen (oder um nach diesen Eigenschaften übertabs.query() zu filtern), benötigen Sie die"tabs"Berechtigung oderHost-Berechtigungen, die mitTab.url übereinstimmen.
- Der Zugriff auf diese Eigenschaften durch Host-Berechtigungen wird seit Firefox 86 und Chrome 50 unterstützt. In Firefox 85 und älter war stattdessen die "tabs"-Berechtigung erforderlich.
Umtabs.executeScript() odertabs.insertCSS() zu verwenden, müssen Sie dieHost-Berechtigung für das Tab haben.

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

Viele Tab-Operationen verwenden eine Tab-id. Tab-ids sind nur innerhalb einer Browser-Sitzung für ein einzelnes Tab eindeutig garantiert. Wenn der Browser neu gestartet wird, können Tab-ids wiederverwendet werden. Um Informationen mit einem Tab über Browser-Neustarts hinweg zu verknüpfen, verwenden Siesessions.setTabValue().

Typen

tabs.MutedInfoReason: Gibt den Grund an, warum ein Tab stummgeschaltet oder lautgeschaltet wurde.
tabs.MutedInfo: Dieses Objekt enthält einen booleschen Wert, der angibt, ob das 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 Methodetabs.saveAsPDF() gerendert wird.
tabs.Tab: Dieser Typ enthält Informationen über ein Tab.
tabs.TabStatus: Gibt an, ob das Tab das Laden abgeschlossen hat.
tabs.WindowType: Der Fenstertyp, der dieses Tab hostet.
tabs.ZoomSettingsMode: Definiert, ob Zoomänderungen vom Browser, von der Erweiterung oder gar nicht gehandhabt werden.
tabs.ZoomSettingsScope: Definiert, ob Zoomänderungen für den Ursprung der Seite bestehen bleiben oder nur in diesem Tab wirksam sind.
tabs.ZoomSettings: Definiert Zoom-Einstellungenmode,scope, und den Standard-Zoomfaktor.

Eigenschaften

tabs.TAB_ID_NONE: Ein spezieller ID-Wert, der Tabs zugewiesen wird, die keine Browser-Tabs sind (zum Beispiel Tabs in Entwicklerwerkzeug-Fenstern).

Funktionen

tabs.captureTab(): Erstellt eine Daten-URL, die ein Bild des sichtbaren Bereichs des angegebenen Tabs kodiert.
tabs.captureVisibleTab(): Erstellt eine Daten-URL, die ein Bild des sichtbaren Bereichs des aktuell aktiven Tabs im angegebenen Fenster kodiert.
tabs.connect(): Richtet eine Nachrichtenverbindung zwischen den Hintergrundskripten der Erweiterung (oder anderen privilegierten Skripten, wie Popup-Skripten oder Optionsseiten-Skripten) und den im angegebenen Tab ausgeführtenInhalts-Skripten ein.
tabs.create(): Erstellt ein neues Tab.
tabs.detectLanguage(): Erkennt die primäre Sprache des Inhalts in einem Tab.
tabs.discard(): Entlädt ein oder mehrere Tabs.
tabs.duplicate(): Dupliziert ein Tab.
tabs.executeScript() (Nur Manifest V2): Injiziert JavaScript-Code in eine Seite.
tabs.get(): Ruft Details über das angegebene Tab ab.
tabs.getAllInWindow()Veraltet: Ruft Details über alle Tabs im angegebenen Fenster ab.
tabs.getCurrent(): Ruft Informationen über das Tab ab, in dem dieses Skript ausgeführt wird, als eintabs.Tab-Objekt.
tabs.getSelected()Veraltet: Ruft das im angegebenen Fenster ausgewählte 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 Zoom-Einstellungen für das angegebene Tab ab.
tabs.goForward(): Geht zur nächsten Seite weiter, falls eine vorhanden ist.
tabs.goBack(): Geht zur vorherigen Seite zurück, falls eine vorhanden ist.
tabs.group(): Fügt Tabs zu einer Tab-Gruppe hinzu.
tabs.hide()Experimentell: Verbirgt ein oder mehrere Tabs.
tabs.highlight(): Markiert ein oder mehrere Tabs.
tabs.insertCSS() (Nur Manifest V2): Injiziert CSS in eine Seite.
tabs.move(): Verschiebt ein oder mehrere Tabs in eine neue Position im gleichen Fenster oder in ein anderes Fenster.
tabs.moveInSuccession(): Modifiziert die Abhängigkeit in der Reihenfolge für eine Gruppe von Tabs.
tabs.print(): Druckt den Inhalt des aktiven Tabs.
tabs.printPreview(): Öffnet die Druckvorschau für das aktive Tab.
tabs.query(): Ruft alle Tabs mit den angegebenen Eigenschaften ab, oder alle Tabs, wenn keine Eigenschaften angegeben sind.
tabs.reload(): Lädt ein Tab erneut, optional unter Umgehung des lokalen Webcaches.
tabs.remove(): Schließt ein oder mehrere Tabs.
tabs.removeCSS() (Nur Manifest V2): Entfernt aus einer Seite CSS, das zuvor durch einen Aufruf vontabs.insertCSS() injiziert wurde.
tabs.saveAsPDF(): Speichert die aktuelle Seite als PDF.
tabs.sendMessage(): Sendet eine einzelne Nachricht an das/die Inhalts-Skript(e) im angegebenen Tab.
tabs.sendRequest()Veraltet: Sendet eine einzelne Anfrage an das/die Inhalts-Skript(e) im angegebenen Tab.Veraltet: Verwenden Sie statt dessen tabs.sendMessage().
tabs.setZoom(): Zoomt das angegebene Tab.
tabs.setZoomSettings(): Legt die Zoom-Einstellungen für das angegebene Tab fest.
tabs.show()Experimentell: Zeigt ein oder mehrere zuvor versteckte Tabs an.
tabs.toggleReaderMode(): Schaltet den Leser-Modus für das angegebene Tab um.
tabs.ungroup(): Entfernt Tabs aus Tab-Gruppen.
tabs.update(): Navigiert das Tab zu einer neuen URL oder ändert andere Eigenschaften des Tabs.
tabs.warmup(): Bereitet das Tab vor, um einen potenziellen folgenden Wechsel schneller zu machen.

Ereignisse

tabs.onActivated: Wird ausgelöst, wenn sich das aktive Tab in einem Fenster ändert. Beachten Sie, dass die URL des Tabs möglicherweise nicht gesetzt ist, wenn dieses Ereignis ausgelöst wird.
tabs.onActiveChangedVeraltet: Wird ausgelöst, wenn sich das ausgewählte Tab in einem Fenster ändert.Veraltet: Verwenden Sie statt dessen 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 gesetzt ist, wenn dieses Ereignis ausgelöst wird.
tabs.onDetached: Wird ausgelöst, wenn ein Tab von einem Fenster abgetrennt wird, zum Beispiel weil es zwischen Fenstern verschoben wird.
tabs.onHighlightChangedVeraltet: Wird ausgelöst, wenn sich die markierten oder ausgewählten Tabs in einem Fenster ändern.Veraltet: Verwenden Sie statt dessen tabs.onHighlighted.
tabs.onHighlighted: Wird ausgelöst, wenn sich die markierten 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 ein anderes Tab aufgrund von Vorab-Rendering ersetzt wird.
tabs.onSelectionChangedVeraltet: Wird ausgelöst, wenn sich das ausgewählte Tab in einem Fenster ändert.Veraltet: Verwenden Sie statt dessen tabs.onActivated.
tabs.onUpdated: Wird ausgelöst, wenn ein Tab aktualisiert wird.
tabs.onZoomChange: Wird ausgelöst, wenn ein Tab gezoomt wird.

Beispielerweiterungen

Browser-Kompatibilität

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

Help improve MDN

Learn how to contribute Diese Seite wurde automatisch aus dem Englischen übersetzt.

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

Movatterモバイル変換