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, welchen Inhalt der Tab hat, 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 momentan nicht fokussiert ist.

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

attention Optional

boolean. Gibt an, ob der Tab Aufmerksamkeit erregt. Zum Beispiel, wenn der Tab einen modalen Dialog anzeigt, wird attention auf true gesetzt.

audible Optional

boolean. Gibt an, ob der Tab Sound produziert. Der Benutzer hört den Sound jedoch nicht, wenn der Tab stummgeschaltet ist (siehe die Eigenschaft mutedInfo).

autoDiscardable Optional

boolean. Ob der Tab von dem Browser verworfen werden kann. Der Standardwert ist true. Wenn auf false gesetzt, 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. Siehe Mit kontextbezogenen Identitäten arbeiten für mehr Informationen.

discarded Optional

boolean. Ob der Tab verworfen ist. Ein verworfener Tab ist einer, dessen Inhalt aus dem Speicher entladen wurde, aber noch in der Tab-Leiste sichtbar ist. Sein Inhalt wird neu geladen, das nächste Mal, 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. Es kann auch undefined sein, wenn die Seite kein Favicon hat, oder ein leerer String, wenn der Tab lädt.

groupId Optional

integer. Die ID der Tabgruppe, zu der der Tab gehört. Auf -1 (tabGroups.TAB_GROUP_ID_NONE) gesetzt, wenn der Tab keiner Tabgruppe angehört. Siehe tabs.group. Für mehr Informationen über Tabgruppen siehe tabGroups.

height Optional

integer. Die Höhe des Tabs in Pixeln.

hidden

boolean. Ob der Tab verborgen ist.

highlighted

boolean. Ob der Tab hervorgehoben ist, d.h. Teil der aktuellen Tab-Auswahl ist. Ein aktiver Tab ist immer hervorgehoben, aber einige Browser können das Hervorheben zusätzlicher Tabs ermöglichen, z.B. durch Klicken bei gedrückter Strg, Umschalt oder ⌘ Befehl-Taste.

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

id Optional

integer. Die ID des Tabs. Tab-IDs sind innerhalb einer Browsersitzung eindeutig. Die Tab-ID kann auch auf tabs.TAB_ID_NONE gesetzt sein für Browserfenster, die keine Inhaltstabs beherbergen (zum Beispiel Developer-Tools-Fenster).

incognito

boolean. Ob der Tab in einem privaten Browserfenster ist.

index

integer. Der nullbasierte Index des Tabs innerhalb seines Fensters.

isArticle

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

isInReaderMode

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

lastAccessed Optional

double. Zeitpunkt, zu dem der Tab zuletzt aufgerufen wurde, in Millisekunden seit dem Epoch.

mutedInfo Optional

tabs.MutedInfo. Der aktuelle stummgeschaltete Zustand des Tabs und der Grund für die letzte Zustandsänderung.

openerTabId Optional

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

pendingUrl

string. Die URL, zu der der Tab navigiert, bevor sie bestätigt wurde. Diese Eigenschaft ist nur vorhanden, wenn das Manifest der Erweiterung die „tabs“-Berechtigung enthält und es eine ausstehende Navigation gibt.

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 ein Tab eindeutig zu identifizieren, das von der sessions API erhalten wurde.

splitViewId Optional

integer. Die ID der geteilten Ansicht, zu der der Tab gehört. Auf tabs.SPLIT_VIEW_ID_NONE gesetzt, wenn der Tab keiner geteilten Ansicht angehört.

status Optional

string. Entweder loading oder complete.

successorTabId Optional

integer. Die ID des Nachfolger-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 passen.

url Optional

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

width Optional

integer. Die Breite des Tabs in Pixeln.

windowId

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

Beispielerweiterungen

Browser-Kompatibilität

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