Le type tabs.Tab contient des informations sur un onglet. Cela donne accès à des informations sur le contenu de l'onglet, la taille du contenu, les états spéciaux ou les restrictions en vigueur, etc.

Type

Les valeurs de ce type sont des objets. Ils contiennent les propriétés suivantes :

active
boolean. Si l'onglet est actif dans sa fenêtre. Cela peut être vrai même si la fenêtre de l'onglet n'est pas actuellement focalisée.
audible Facultatif
boolean. Si l'onglet n'est pas coupé: si l'onglet produit du son. Si l'onglet est coupé: si l'onglet produit un son, s'il n'est pas muet.
autoDiscardable Facultatif
boolean. Si l'onglet peut être supprimé automatiquement par le navigateur lorsque les ressources sont faibles.
cookieStoreId Facultatif
string. Le magasin de cookies de l'onglet. Si différents onglets peuvent avoir différents magasins de cookies (par exemple, pour prendre en charge l'identitié contextuelle), vous pouvez passer cette option storeId dans différentes méthodes de l'API cookies, pour définir et obtenir des cookies associés à Le magasin de cookies de cet onglet. Seulement présent si l'extension a la permission "cookies".
discarded Facultatif
boolean. Si l'onglet est ignoré. Un onglet supprimé est celui dont le contenu a été déchargé de la mémoire, mais est toujours visible dans la bande d'onglets. Son contenu est rechargé la prochaine fois qu'il est activé.
favIconUrl Facultatif
string. L'URL de la favicon de l'onglet. Seulement présent si l'extension a la permission "tabs". Il peut également s'agir d'une chaîne vide si l'onglet est en cours de chargement.
height Facultatif
integer. La hauteur de l'onglet en pixels.
hidden
boolean. Si l'onglet est caché.
highlighted
boolean. Si l'onglet est en surbrillance.
id Facultatif
integer. L'ID de l'onglet. Les ID d'onglet sont uniques dans une session de navigateur. L'ID d'onglet peut également être défini sur  tabs.TAB_ID_NONE pour les fenêtres de navigateur qui n'hébergent pas d'onglets de contenu (par exemple, les fenêtres devtools).
incognito
boolean. Si l'onglet est dans une fenêtre de navigation privée.
index
integer. L'indice de base zéro de l'onglet dans sa fenêtre.
isArticle
boolean. Vrai si l'onglet peut être rendu en mode lecteur, sinon faux.
isInReaderMode
boolean. Vrai si l'onglet en cours de rendu en mode lecteur, sinon faux.
lastAccessed
double. Heure à laquelle l'onglet a été accédé pour la dernière fois, en millisecondes depuis l'époque.
mutedInfo Facultatif
tabs.MutedInfo. L'état en sourdine actuel pour l'onglet et la raison du dernier changement d'état.
openerTabId Facultatif
integer. L'ID de l'onglet qui a ouvert cet onglet, le cas échéant. Cette propriété n'est présente que si l'onglet d'ouverture existe toujours.
pinned
boolean. Si l'onglet est épinglé.
selected
boolean. Si l'onglet est sélectionné.
sessionId Facultatif
string. L'identifiant de session utilisé pour identifier de façon unique un onglet  obtenu à partir de l'API sessions.
status Facultatif
string. Soit charger ou compléter.
title Facultatif
string. Le titre de l'onglet. Seulement présent si l'extension à la permission "tabs".
url Facultatif
string. L'URL du document que l'onglet affiche. Seulement présent si l'extension à la permission "tabs".
width Facultatif
integer. La largeur de l'onglet en pixels
windowId
integer. L'ID de la fenêtre qui héberge cet onglet.

Compatibilité du navigateur

ChromeEdgeFirefoxFirefox for AndroidOpera
active Oui Oui4554 Oui
audible45 Non455432
autoDiscardable54 Non Non Non41
cookieStoreId Non Non52 Non Non
discarded54 Non575741
favIconUrl Oui Oui45 Non Oui
height31 Non455418
highlighted Oui Non4554 Oui
id Oui Oui4554 Oui
incognito Oui Oui14554 Oui
index Oui Oui4554 Oui
isArticle Non Non58 Non Non
isInReaderMode Non Non58 Non Non
lastAccessed Non Non5656 Non
mutedInfo46 Non455433
openerTabId18 Non57 Non15
pinned Oui Oui4554 Oui
selected Oui Non4554 Oui
sessionId31 Non Non Non18
status Oui Oui4554 Oui
title Oui Oui4554 Oui
url Oui Oui4554 Oui
width31 Non455418
windowId Oui Oui4554 Oui

1. Supported as inPrivate.

Remerciements :

Cette API est basée sur l'API Chromium chrome.tabs. Cette documentation est dérivée de tabs.json dans le code de Chromium code.

Les données de compatibilité relatives à Microsoft Edge sont fournies par Microsoft Corporation et incluses ici sous la licence Creative Commons Attribution 3.0 pour les États-Unis.

Étiquettes et contributeurs liés au document

Contributeurs à cette page : hellosct1
Dernière mise à jour par : hellosct1,