tabs.Tab
Der Typ tabs.Tab
enthält Informationen über einen Tab. Dies ermöglicht den Zugriff auf Informationen darüber, welcher Inhalt im Tab ist, wie groß der Inhalt ist, welche besonderen Zustände oder Einschränkungen gelten und so weiter.
Typ
Werte dieses Typs sind Objekte. Sie enthalten die folgenden Eigenschaften:
active
-
boolean
. Gibt an, ob der Tab in seinem Fenster aktiv ist. Dies kann auch wahr sein, wenn das Fenster des Tabs momentan nicht fokussiert ist.Der aktive Tab ist normalerweise der ausgewählte. Auf Firefox für Android öffnen Erweiterungs-Popups 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. Zum Beispiel, wenn der Tab ein modales Dialogfeld anzeigt, wirdattention
true
sein. audible
Optional-
boolean
. Gibt an, ob der Tab Ton produziert. Der Benutzer wird den Ton jedoch nicht hören, wenn der Tab stummgeschaltet ist (siehe diemutedInfo
-Eigenschaft). autoDiscardable
Optional-
boolean
. Ob der Tab vom Browser entfernt werden kann. Der Standardwert isttrue
. Wenn auffalse
gesetzt, kann der Browser den Tab nicht automatisch entfernen. Der Tab kann jedoch durchtabs.discard
entfernt werden. -
string
. Der Cookie-Store des Tabs. Siehe Arbeiten mit kontextabhängigen Identitäten für weitere Informationen. discarded
Optional-
boolean
. Ob der Tab verworfen ist. Ein verworfener Tab ist einer, dessen Inhalt aus dem Speicher entladen wurde, aber immer noch in der Tab-Leiste sichtbar ist. Sein Inhalt wird neu geladen, wenn er das nächste Mal 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 auchundefined
sein, wenn die Seite kein Favicon hat, oder eine leere Zeichenfolge, wenn der Tab lädt. groupId
Optional-
integer
. Die ID der Tab-Gruppe, zu der der Tab gehört. Auf-1
gesetzt, wenn der Tab keiner Tab-Gruppe angehört. Siehetabs.group
. height
Optional-
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. Ein aktiver Tab ist immer hervorgehoben, aber einige Browser können es ermöglichen, zusätzliche Tabs hervorzuheben, z. B. durch Klicken bei gedrückter Strg-, Umschalt- oder ⌘ Command-Taste.Firefox für Android unterstützt das Hervorheben mehrerer Tabs nicht.
id
Optional-
integer
. Die ID des Tabs. Tab-IDs sind innerhalb einer Browser-Sitzung eindeutig. Die Tab-ID kann auch auftabs.TAB_ID_NONE
gesetzt sein für Browserfenster, die keine Inhalts-Tabs hosten (zum Beispiel Entwicklertools-Fenster). incognito
-
boolean
. Ob der Tab in einem privaten Fenster ist. index
-
integer
. Der nullbasierte Index des Tabs innerhalb seines Fensters. isArticle
-
boolean
.True
wenn der Tab im Reader-Modus gerendert werden kann, andernfallsfalse
. isInReaderMode
-
boolean
.True
wenn der Tab momentan im Reader-Modus gerendert wird, andernfallsfalse
. lastAccessed
Optional-
double
. Zeitpunkt, zu dem der Tab zuletzt aufgerufen wurde, in Millisekunden seit der Epoche. mutedInfo
Optional-
tabs.MutedInfo
. Der aktuelle stummgeschaltete Zustand 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 selben 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 "tabs"-Berechtigung enthält und eine ausstehende Navigation besteht. pinned
-
boolean
. Ob der Tab angeheftet ist. selected
Veraltet-
boolean
. Ob der Tab ausgewählt ist. Diese Eigenschaft wurde durchactive
undhighlighted
ersetzt. sessionId
Optional-
string
. Die Sitzungs-ID, die verwendet wird, um einenTab
, der von dersessions
API erhalten wurde, eindeutig zu identifizieren. 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 passt. 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 hostet.
Browser-Kompatibilität
Beispielerweiterungen
Hinweis:
Diese API basiert auf der chrome.tabs
API von Chromium. Diese Dokumentation stammt aus tabs.json
im Chromium-Code.