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.
attentionOptional-
boolean. Gibt an, ob der Tab Aufmerksamkeit erregt. Zum Beispiel, wenn der Tab einen modalen Dialog anzeigt, wirdattentionauftruegesetzt. audibleOptional-
boolean. Gibt an, ob der Tab Sound produziert. Der Benutzer hört den Sound jedoch nicht, wenn der Tab stummgeschaltet ist (siehe die EigenschaftmutedInfo). autoDiscardableOptional-
boolean. Ob der Tab von dem Browser verworfen werden kann. Der Standardwert isttrue. Wenn auffalsegesetzt, kann der Browser den Tab nicht automatisch verwerfen. Der Tab kann jedoch durchtabs.discardverworfen werden. -
string. Der Cookie-Store des Tabs. Siehe Mit kontextbezogenen Identitäten arbeiten für mehr Informationen. discardedOptional-
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. favIconUrlOptional-
string. Die URL des Favicons des Tabs. Nur vorhanden, wenn die Erweiterung die"tabs"Berechtigung oder Host-Berechtigungen hat. Es kann auchundefinedsein, wenn die Seite kein Favicon hat, oder ein leerer String, wenn der Tab lädt. groupIdOptional-
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. Siehetabs.group. Für mehr Informationen über Tabgruppen siehetabGroups. heightOptional-
integer. Die Höhe des Tabs in Pixeln. -
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.
idOptional-
integer. Die ID des Tabs. Tab-IDs sind innerhalb einer Browsersitzung eindeutig. Die Tab-ID kann auch auftabs.TAB_ID_NONEgesetzt 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. lastAccessedOptional-
double. Zeitpunkt, zu dem der Tab zuletzt aufgerufen wurde, in Millisekunden seit dem Epoch. mutedInfoOptional-
tabs.MutedInfo. Der aktuelle stummgeschaltete Zustand des Tabs und der Grund für die letzte Zustandsänderung. openerTabIdOptional-
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. selectedVeraltet-
boolean. Ob der Tab ausgewählt ist. Diese Eigenschaft wurde durchactiveundhighlightedersetzt. sessionIdOptional-
string. Die Sitzungs-ID, die verwendet wird, um einTabeindeutig zu identifizieren, das von dersessionsAPI erhalten wurde. splitViewIdOptional-
integer. Die ID der geteilten Ansicht, zu der der Tab gehört. Auftabs.SPLIT_VIEW_ID_NONEgesetzt, wenn der Tab keiner geteilten Ansicht angehört. statusOptional-
string. Entweder loading oder complete. successorTabIdOptional-
integer. Die ID des Nachfolger-Tabs. titleOptional-
string. Der Titel des Tabs. Nur vorhanden, wenn die Erweiterung die"tabs"Berechtigung oder Host-Berechtigungen hat, die zur URL des Tabs passen. urlOptional-
string. Die URL des Dokuments, das der Tab anzeigt. Nur vorhanden, wenn die Erweiterung die"tabs"Berechtigung oder eine passende Host-Berechtigung hat. widthOptional-
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.