tabs.Tab
Der Typ tabs.Tab
enthält Informationen über einen Tab. Dies bietet Zugriff auf Informationen darüber, welche Inhalte im Tab sind, 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
. Gibt an, ob der Tab in seinem Fenster aktiv ist. Dies kann auch dann wahr sein, wenn das Fenster des Tabs derzeit 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 wird, ist stattdessen der Tab aktiv, 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, 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 die EigenschaftmutedInfo
). autoDiscardable
Optional-
boolean
. Gibt an, ob der Tab vom Browser verworfen werden kann. Der Standardwert isttrue
. Wenn auffalse
gesetzt, kann der Browser den Tab nicht automatisch verwerfen. Der Tab kann jedoch durchtabs.discard
verworfen werden. -
string
. Der Cookie-Speicher des Tabs. Weitere Informationen finden Sie unter Mit kontextuellen Identitäten arbeiten. discarded
Optional-
boolean
. Gibt an, ob der Tab verworfen wurde. Ein verworfener Tab ist einer, dessen Inhalt aus dem Speicher entladen wurde, aber weiterhin im Tabstreifen 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 die Berechtigung"tabs"
Berechtigung oder Host-Berechtigungen hat. Es kann auchundefined
sein, wenn die Seite kein Favicon hat, oder ein leerer String, wenn der Tab lädt. groupId
Optional-
integer
. Die ID der Tab-Gruppe, zu der der Tab gehört. Wird auf-1
gesetzt (tabGroups.TAB_GROUP_ID_NONE
), wenn der Tab keiner Tab-Gruppe angehört. Weitere Informationen zu Tab-Gruppen finden Sie untertabGroups
. height
Optional-
integer
. Die Höhe des Tabs in Pixeln. -
boolean
. Gibt an, ob der Tab versteckt ist. highlighted
-
boolean
. Gibt an, ob der Tab hervorgehoben ist, d.h. Teil der aktuellen Tab-Auswahl ist. Ein aktiver Tab ist immer hervorgehoben, aber einige Browser erlauben möglicherweise zusätzliche Tabs zu markieren, zum Beispiel durch Klicken mit gedrückter Ctrl-, Shift- oder ⌘ Command-Taste.Firefox für Android unterstützt keine Hervorhebung mehrerer Tabs.
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 Inhalts-Tabs hosten (zum Beispiel Devtools-Fenster). incognito
-
boolean
. Gibt an, ob sich der Tab in einem privaten Fenster befindet. index
-
integer
. Der nullbasierte Index des Tabs innerhalb seines Fensters. isArticle
-
boolean
. True, wenn der Tab im Leseansichtsmodus gerendert werden kann, false andernfalls. isInReaderMode
-
boolean
. True, wenn der Tab derzeit im Leseansichtsmodus gerendert wird, false andernfalls. lastAccessed
Optional-
double
. Zeit, zu der der Tab zuletzt aufgerufen wurde, in Millisekunden seit der Epoche. mutedInfo
Optional-
tabs.MutedInfo
. Der aktuelle Stummschaltungsstatus für den Tab 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 im selben Fenster ist. pendingUrl
-
string
. Die URL, zu der der Tab navigiert, bevor sie festgelegt wurde. Diese Eigenschaft ist nur vorhanden, wenn das Manifest der Erweiterung die Berechtigung "tabs" enthält und eine ausstehende Navigation vorliegt. pinned
-
boolean
. Gibt an, 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
eindeutig zu identifizieren, der von dersessions
API erhalten wurde. status
Optional-
string
. Entweder loading oder complete. successorTabId
Optional-
integer
. Die ID des Nachfolgetabs des Tabs. title
Optional-
string
. Der Titel des Tabs. Nur vorhanden, wenn die Erweiterung die"tabs"
Berechtigung oder Host-Berechtigungen besitzt, 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 hostet.
Browser-Kompatibilität
Beispielerweiterungen
Hinweis:
Diese API basiert auf Chromiums chrome.tabs
API. Diese Dokumentation wird aus tabs.json
im Chromium-Code abgeleitet.