tabs.Tab
Der Typ tabs.Tab
enthält Informationen über einen Tab. Er bietet 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
. Ob der Tab in seinem Fenster aktiv ist. Dies kann auch dann zutreffen, wenn das Fenster des Tabs nicht derzeit 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 wird, ist der aktive Tab stattdessen der, in dem das Popup geöffnet wurde.
attention
Optional-
boolean
. Gibt an, ob der Tab Aufmerksamkeit erregt. Wenn der Tab beispielsweise ein modales Dialogfeld anzeigt, wirdattention
auftrue
gesetzt. audible
Optional-
boolean
. Zeigt an, ob der Tab Ton produziert. Der Benutzer hört den Ton jedoch nicht, wenn der Tab stummgeschaltet ist (siehe die EigenschaftmutedInfo
). autoDiscardable
Optional-
boolean
. 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. 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, der aber weiterhin im Tabstreifen sichtbar ist. Sein Inhalt wird das nächste Mal neu geladen, wenn er 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 ein leerer String, wenn der Tab lädt. 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 Tabauswahl ist. Ein aktiver Tab ist immer hervorgehoben, aber einige Browser erlauben es möglicherweise, zusätzliche Tabs hervorzuheben, z.B. durch Klicken auf sie, während die Tasten Ctrl, Shift oder ⌘ Command gedrückt 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 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
. Wahr, wenn der Tab im Lesemodus angezeigt werden kann, andernfalls falsch. isInReaderMode
-
boolean
. Wahr, wenn der Tab derzeit im Lesemodus angezeigt wird, andernfalls falsch. lastAccessed
Optional-
double
. Zeit, zu der 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 bestätigt wurde. Diese Eigenschaft ist nur vorhanden, wenn das Manifest der Erweiterung die "tabs"-Berechtigung enthält und eine ausstehende Navigation vorliegt. 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 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 Nachfolgers des Tabs. title
Optional-
string
. Der Titel des Tabs. Nur vorhanden, wenn die Erweiterung die"tabs"
Berechtigung oder eine passende Host-Berechtigungen hat, die mit der URL des Tabs übereinstimmt. url
Optional-
string
. Die URL des Dokuments, das der Tab anzeigt. Nur vorhanden, wenn die Erweiterung die"tabs"
Berechtigung oder eine passende Host-Berechtigungen hat. width
Optional-
integer
. Die Breite des Tabs in Pixeln. windowId
-
integer
. Die ID des Fensters, das diesen Tab hostet.
Browser-Kompatibilität
BCD tables only load in the browser
Beispielerweiterungen
Hinweis:
Diese API basiert auf Chromiums chrome.tabs
API. Diese Dokumentation stammt von tabs.json
im Chromium-Code.