tabs.Tab
Der Typ tabs.Tab
enthält Informationen über einen Tab. Er bietet Zugriff auf Informationen darüber, welche Inhalte im Tab sind, wie groß der Inhalt ist, welche speziellen Zustände oder Einschränkungen aktiv sind und so weiter.
Typ
Werte dieses Typs sind Objekte. Sie enthalten die folgenden Eigenschaften:
active
-
boolean
. Ob der Tab innerhalb seines Fensters aktiv ist. Dies kann auch der Fall sein, wenn das Fenster des Tabs nicht aktuell fokussiert ist.Der aktive Tab ist in der Regel der ausgewählte. Auf Firefox für Android öffnen Erweiterungspopups jedoch in einem neuen Tab. Wenn dieser Popup-Tab ausgewählt ist, wird der aktive Tab stattdessen derjenige sein, in dem das Popup geöffnet wurde.
attention
Optional-
boolean
. Gibt an, ob der Tab Aufmerksamkeit erregt. Beispielsweise wirdattention
auftrue
gesetzt, wenn der Tab ein modales Dialogfenster anzeigt. audible
Optional-
boolean
. Gibt an, ob der Tab Sound abspielt. Der Benutzer wird den Sound jedoch nicht hören, wenn der Tab stummgeschaltet ist (siehe die EigenschaftmutedInfo
). autoDiscardable
Optional-
boolean
. Ob der Tab vom Browser verworfen werden kann. Der Standardwert isttrue
. Wenn der Wert auffalse
gesetzt ist, kann der Browser den Tab nicht automatisch verwerfen. Der Tab kann jedoch durchtabs.discard
verworfen werden. -
string
. Der Cookie-Store des Tabs. Weitere Informationen finden Sie unter Arbeiten mit kontextuellen Identitäten. discarded
Optional-
boolean
. Ob der Tab verworfen ist. Ein verwerfener Tab ist einer, dessen Inhalt aus dem Speicher entladen wurde, der aber weiterhin in der Tableiste sichtbar ist. Sein Inhalt wird beim nächsten Aktivieren neu geladen. favIconUrl
Optional-
string
. Die URL des Favicons des Tabs. Nur vorhanden, wenn die Erweiterung über die"tabs"
Berechtigung oder Host-Berechtigungen verfügt. Sie kann auchundefined
sein, wenn die Seite kein Favicon hat, oder eine leere Zeichenfolge, wenn der Tab gerade lädt. height
Optional-
integer
. Die Höhe des Tabs in Pixeln. -
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, zusätzliche Tabs hervorzuheben, zum Beispiel durch Klicken, während die Tasten Ctrl, Shift oder ⌘ Command gedrückt gehalten werden.Firefox für Android unterstützt das Hervorheben mehrerer Tabs nicht.
id
Optional-
integer
. Die ID des Tabs. Tab-IDs sind innerhalb einer Browsersitzung eindeutig. Die Tab-ID kann auch auftabs.TAB_ID_NONE
gesetzt werden für Browserfenster, die keine Inhalte-Tabs beherbergen (z.B. Devtools-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 dargestellt werden kann, andernfalls falsch. isInReaderMode
-
boolean
. Wahr, wenn der Tab aktuell im Reader-Modus dargestellt wird, andernfalls falsch. lastAccessed
Optional-
double
. Zeitpunkt, zu dem der Tab zuletzt besucht wurde, in Millisekunden seit der Epoche. mutedInfo
Optional-
tabs.MutedInfo
. Der aktuelle Stummschaltungszustand für den Tab und der Grund für die letzte Zustandsä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 gleichen Fenster befindet. pendingUrl
-
string
. Die URL, zu der der Tab navigiert, bevor sie abgeschlossen wurde. Diese Eigenschaft ist nur vorhanden, wenn das Manifest der Erweiterung die Berechtigung "tabs" enthält und eine ausstehende Navigation stattfindet. pinned
-
boolean
. Ob der Tab angepinnt ist. selected
Veraltet-
boolean
. Ob der Tab ausgewählt ist. Diese Eigenschaft wurde durchactive
undhighlighted
ersetzt. sessionId
Optional-
string
. Die Sitzungs-ID, die zum eindeutigen Identifizieren einesTab
aus dersessions
API verwendet wird. 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 mit der URL des Tabs übereinstimmen. 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.
Browser-Kompatibilität
Beispielerweiterungen
Hinweis:
Diese API basiert auf der chrome.tabs
API von Chromium. Diese Dokumentation stammt aus tabs.json
im Chromium-Code.