tabs.Tab
Der Typ tabs.Tab
enthält Informationen über einen Tab. Dies ermöglicht den Zugriff auf Informationen darüber, welche Inhalte sich im Tab befinden, wie groß der Inhalt ist, welche speziellen Zustände oder Einschränkungen gelten 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 auch dann der Fall sein, wenn das Fensters des Tabs nicht aktuell 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
. Zeigt an, ob der Tab Aufmerksamkeit erregt. Zum Beispiel, wenn der Tab einen modalen Dialog anzeigt, wirdattention
true
sein. audible
Optional-
boolean
. Gibt an, ob der Tab Ton erzeugt. Der Benutzer wird den Ton 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 er auffalse
gesetzt ist, kann der Browser den Tab nicht automatisch verwerfen. Der Tab kann jedoch mittabs.discard
verworfen werden. -
string
. Der Cookie-Store des Tabs. Siehe Arbeiten mit kontextuellen Identitäten für weitere Informationen. discarded
Optional-
boolean
. Ob der Tab verworfen wurde. Ein verworfener Tab ist einer, dessen Inhalt aus dem Speicher entladen wurde, aber weiterhin in der Tab-Leiste 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 ein leerer String, wenn der Tab geladen wird. groupId
Optional-
integer
. Die ID der Tab-Gruppe, zu der der Tab gehört. Auf-1
gesetzt (tabGroups.TAB_GROUP_ID_NONE
), wenn der Tab nicht zu einer Tab-Gruppe gehört. Siehetabs.group
. Für weitere Informationen zu Tab-Gruppen, siehetabGroups
. height
Optional-
integer
. Die Höhe des Tabs in Pixeln. -
boolean
. Ob der Tab versteckt 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, z.B. durch Klicken bei gedrückter Ctrl-, Shift- 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 Browsersitzung eindeutig. Die Tab-ID kann auch auftabs.TAB_ID_NONE
gesetzt sein für Browserfenster, die keine Inhaltstabs hosten (zum Beispiel DevTools-Fenster). incognito
-
boolean
. Ob der Tab in einem privaten Browserfenster ist. index
-
integer
. Der nullbasierte Index des Tabs innerhalb seines Fensters. isArticle
-
boolean
.True
, wenn der Tab im Reader-Modus gerendert werden kann,false
ansonsten. isInReaderMode
-
boolean
.True
, wenn der Tab aktuell im Reader-Modus gerendert wird,false
ansonsten. lastAccessed
Optional-
double
. Zeit in Millisekunden seit der Epoche, zu der zuletzt auf den Tab zugegriffen wurde. mutedInfo
Optional-
tabs.MutedInfo
. Der aktuelle Stummschaltungsstatus des Tabs 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 sie festgeschrieben ist. Diese Eigenschaft ist nur vorhanden, wenn das Manifest der Erweiterung die "tabs"-Berechtigung beinhaltet und eine ausstehende Navigation vorhanden ist. 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 zum eindeutigen Identifizieren einesTab
verwendet wird, der von dersessions
-API erhalten wird. status
Optional-
string
. Entweder loading oder complete. successorTabId
Optional-
integer
. Die ID des Nachfolgertabs. 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 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 aus tabs.json
im Chromium-Code.