Dieser Inhalt wurde automatisch aus dem Englischen übersetzt, und kann Fehler enthalten. Erfahre mehr über dieses Experiment.

View in English Always switch to English

tabs.Tab

Der Typ tabs.Tab enthält Informationen über einen Tab. Dies ermöglicht den Zugriff auf Informationen darüber, welcher Inhalt sich im Tab befindet, wie groß der Inhalt ist, welche speziellen Zustände oder Einschränkungen in Kraft sind und so weiter.

Typ

Werte dieses Typs sind Objekte. Sie enthalten die folgenden Eigenschaften:

active

boolean. Ob der Tab in seinem Fenster aktiv ist. Dies kann wahr sein, auch wenn das Fenster des Tabs derzeit nicht fokussiert ist.

Der aktive Tab ist normalerweise der ausgewählte. Auf Firefox für Android werden Erweiterungs-Popups jedoch in einem neuen Tab geöffnet. Wenn dieser Popup-Tab ausgewählt ist, wird stattdessen der Tab aktiv, in dem das Popup geöffnet wurde.

attention Optional

boolean. Gibt an, ob der Tab Aufmerksamkeit erregt. Wenn der Tab beispielsweise einen modalen Dialog anzeigt, wird attention auf true gesetzt.

audible Optional

boolean. Gibt an, ob der Tab Ton ausgibt. Der Benutzer wird den Ton jedoch nicht hören, wenn der Tab stummgeschaltet ist (siehe die Eigenschaft mutedInfo).

autoDiscardable Optional

boolean. Ob der Tab vom Browser verworfen werden kann. Der Standardwert ist true. Wenn er auf false gesetzt wird, kann der Browser den Tab nicht automatisch verwerfen. Der Tab kann jedoch durch tabs.discard verworfen werden.

cookieStoreId Optional

string. Der Cookie-Store des Tabs. Weitere Informationen finden Sie unter Mit kontextuellen Identitäten arbeiten.

discarded Optional

boolean. Ob der Tab verworfen wurde. Ein verworfener Tab ist einer, dessen Inhalt aus dem Speicher entladen wurde, aber immer noch in der Tableiste sichtbar ist. Sein Inhalt wird das nächste Mal neu geladen, wenn er aktiviert wird.

favIconUrl Optional

string. Die URL des Favicons des Tabs. Nur vorhanden, wenn die Erweiterung die "tabs" Berechtigung oder Host-Berechtigungen hat. Sie kann auch undefined sein, wenn die Seite kein Favicon hat, oder ein leerer String, wenn der Tab geladen wird.

groupId Optional

integer. Die ID der Tab-Gruppe, zu der der Tab gehört. Wird auf -1 (tabGroups.TAB_GROUP_ID_NONE) gesetzt, wenn der Tab keiner Tab-Gruppe zugehört. Siehe tabs.group. Weitere Informationen zu Tab-Gruppen finden Sie unter tabGroups.

height Optional

integer. Die Höhe des Tabs in Pixeln.

hidden

boolean. Ob der Tab ausgeblendet ist.

highlighted

boolean. Ob der Tab hervorgehoben ist, d.h. Teil der aktuellen Tab-Auswahl. Ein aktiver Tab ist immer hervorgehoben, aber einige Browser erlauben es möglicherweise, zusätzliche Tabs hervorzuheben, zum Beispiel durch Anklicken bei gleichzeitigem Drücken der Tasten Ctrl, Shift oder ⌘ Command.

Firefox für Android unterstützt nicht das Hervorheben mehrerer Tabs.

id Optional

integer. Die ID des Tabs. Tab-IDs sind innerhalb einer Browser-Sitzung eindeutig. Die Tab-ID kann auch auf tabs.TAB_ID_NONE gesetzt werden für Browserfenster, die keine Inhalts-Tabs hosten (zum Beispiel devtool-Fenster).

incognito

boolean. Ob der Tab sich in einem privaten Browserfenster befindet.

index

integer. Der nullbasierte Index des Tabs innerhalb seines Fensters.

isArticle

boolean. Wahr, wenn der Tab im Reader-Modus angezeigt werden kann, andernfalls falsch.

isInReaderMode

boolean. Wahr, wenn der Tab derzeit im Reader-Modus angezeigt wird, andernfalls falsch.

lastAccessed Optional

double. Zeitpunkt, zu dem auf den Tab zuletzt zugegriffen wurde, in Millisekunden seit der Epoche.

mutedInfo Optional

tabs.MutedInfo. Der aktuelle Stummschaltungsstatus für den Tab und der Grund für die letzte Statusänderung.

openerTabId Optional

integer. Die ID des Tabs, der diesen Tab geöffnet hat, falls vorhanden. Diese Eigenschaft ist nur vorhanden, wenn der öffnende Tab noch existiert und sich im selben Fenster befindet.

pendingUrl

string. Die URL, zu der der Tab navigiert, bevor er ausgeführt wurde. Diese Eigenschaft ist nur vorhanden, wenn das Manifest der Erweiterung die Berechtigung "tabs" enthält und eine ausstehende Navigation vorliegt.

pinned

boolean. Ob der Tab angeheftet ist.

selected Veraltet

boolean. Ob der Tab ausgewählt ist. Diese Eigenschaft wurde durch active und highlighted ersetzt.

sessionId Optional

string. Die Sitzungs-ID, die verwendet wird, um einen Tab eindeutig zu identifizieren, der von der sessions API bezogen wurde.

splitViewId Optional

integer. Die ID der geteilten Ansicht, zu der der Tab gehört. Wird auf tabs.SPLIT_VIEW_ID_NONE gesetzt, wenn der Tab nicht zu einer geteilten Ansicht gehört.

status Optional

string. Entweder loading oder complete.

successorTabId Optional

integer Die ID des Nachfolgers des Tabs.

title Optional

string. Der Titel des Tabs. Nur vorhanden, wenn die Erweiterung die "tabs" Berechtigung oder Host-Berechtigungen hat, die zur URL des Tabs passt.

url Optional

string. Die URL des Dokuments, das der Tab anzeigt. Nur vorhanden, wenn die Erweiterung die "tabs" Berechtigung oder entsprechende Host-Berechtigungen hat.

width Optional

integer. Die Breite des Tabs in Pixeln.

windowId

integer. Die ID des Fensters, das diesen Tab hostet.

Beispielerweiterungen

Browser-Kompatibilität

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