Interagissez avec le système d'onglets du navigateur.

Vous pouvez utiliser cette API pour obtenir une liste des onglets ouverts, filtrés par différents critères, et ouvrir, mettre à jour, déplacer, recharger et supprimer des onglets. Vous ne pouvez pas accéder directement au contenu hébergé par les onglets à l'aide de cette API, mais vous pouvez insérer JavaScript et CSS dans des onglets en utilisant les API  tabs.executeScript() ou tabs.insertCSS().

Vous pouvez utiliser la plupart de cette API sans aucune autorisation spéciale. Toutefois:

Alternativement, vous pouvez obtenir ces autorisations temporairement, uniquement pour l'onglet courrant actif et uniquement en réponse à une action explicite de l'utilisateur, en demandant la permission "activeTab".

Many tab operations use a Tab ID. Tab IDs are guaranteed to be unique to a single tab only within a browser session. If the browser is restarted, then it can and will reuse tab IDs. To associate information with a tab across browser restarts, use sessions.setTabValue().

Types

tabs.MutedInfoReason
Spécifie la raison pour laquelle un onglet a été désactivé ou non.
tabs.MutedInfo
Cet objet contient un booléen indiquant si l'onglet est coupé et la raison de la dernière modification de l'état.
tabs.PageSettings

Permet de contrôler le rendu d'un onglet au format PDF par la méthode  tabs.saveAsPDF().

tabs.Tab
Ce type contient des informations sur un onglet.
tabs.TabStatus
Indique si l'onglet a fini de charger.
tabs.WindowType
Le type de fenêtre qui héberge cet onglet.
tabs.ZoomSettingsMode
Définit si les modifications de zoom sont traitées par le navigateur, par l'extension ou sont désactivées.
tabs.ZoomSettingsScope
Définit si les modifications de zoom persisteront pour la page de l'origine ou ne prendront effet que dans cet onglet.
tabs.ZoomSettings
Définit les configurations de zoom mode, scope, et facteur de zoom par défaut.

Propriétés

tabs.TAB_ID_NONE
Une valeur d'ID spéciale donnée aux onglets qui ne sont pas les onglets du navigateur (par exemple, les onglets dans les fenêtres devtools).

Fonctions

 

tabs.captureTab()
Crée un URI de données codant une image de la zone visible de l'onglet donné.
tabs.captureVisibleTab()
Crée un URI de données codant une image de la zone visible de l'onglet actuellement actif dans la fenêtre spécifiée.
tabs.connect()
Définit une connexion de messagerie entre les scripts d'arrière-plan du module complémentaire (ou d'autres scripts privilégiés, tels que les scripts contextuels ou les scripts de page d'options) et les scripts de contenu s'exécutant dans l'onglet spécifié.
tabs.create()
Crée un nouvel onglet.
tabs.detectLanguage()
Détecte la langue principale du contenu dans un onglet.
tabs.discard()
Rejette un ou plusieurs onglets.
tabs.duplicate()
Duplique un onglet.
tabs.executeScript()
Injecte du code JavaScript dans une page.
tabs.get()
Récupère des détails sur l'onglet spécifié.
tabs.getAllInWindow()
Obtient des détails sur tous les onglets de la fenêtre spécifiée.
tabs.getCurrent()
Obtient des informations sur l'onglet dans lequel ce script s'exécute, en tant qu'objet tabs.Tab.
tabs.getSelected()
Obtient l'onglet sélectionné dans la fenêtre spécifiée.
tabs.getZoom()
Obtient le facteur de zoom actuel de l'onglet spécifié.
tabs.getZoomSettings()
Obtient les paramètres de zoom actuels pour l'onglet spécifié.
tabs.hide()
Masque un ou plusieurs onglets.
tabs.highlight()
Met en évidence un ou plusieurs onglets..
tabs.insertCSS()
Injecte CSS dans une page.
tabs.move()
Déplace un ou plusieurs onglets vers une nouvelle position dans la même fenêtre ou vers une autre fenêtre.
tabs.print()
Imprime le contenu de l'onglet actif.
tabs.printPreview()
Ouvre l'aperçu avant impression pour l'onglet actif.
tabs.query()
Obtient tous les onglets qui ont les propriétés spécifiées, ou tous les onglets si aucune propriété n'est spécifiée.
tabs.reload()
Rechargez un onglet, en contournant éventuellement le cache Web local.
tabs.remove()
Ferme un ou plusieurs onglets.
tabs.removeCSS()
Supprime d'une page CSS qui a été précédemment injectée en appelant tabs.insertCSS().
tabs.saveAsPDF()
Enregistre la page en cours en format PDF.
tabs.sendMessage()
Envoie un seul message au (x) script (s) de contenu dans l'onglet spécifié.
tabs.sendRequest()
Envoie une seule requête au(x) script(s) de contenu dans l'onglet spécifié. Déconseillé : utilisez  tabs.sendMessage() à la place.
tabs.setZoom()
Effectue un zoom sur l'onglet spécifié.
tabs.setZoomSettings()
Définit les paramètres de zoom pour l'onglet spécifié.
tabs.show()
Affiche un ou plusieurs onglets qui ont été hidden.
tabs.toggleReaderMode()
Bascule en mode Lecteur pour l'onglet spécifié.
tabs.update()
Parcourez l'onglet vers une nouvelle URL ou modifiez d'autres propriétés de l'onglet.

Evénements

tabs.onActivated
Se déclenche lorsque l'onglet actif dans une fenêtre change. Notez que l'URL de l'onglet peut ne pas être définie au moment où cet événement a été déclenché.
tabs.onActiveChanged
Se déclenche lorsque l'onglet sélectionné dans une fenêtre change. Déconseillé : utilisez  tabs.onActivated à la place.
tabs.onAttached
Lancé lorsqu'un onglet est attaché à une fenêtre, par exemple parce qu'il a été déplacé entre les fenêtres..
tabs.onCreated
Lancé lorsqu'un onglet est créé. Notez que l'URL de l'onglet peut ne pas être définie au moment où cet événement a été déclenché.
tabs.onDetached
Lancé lorsqu'un onglet est détaché d'une fenêtre, par exemple parce qu'il est déplacé entre des fenêtres.
tabs.onHighlightChanged
Lancé lorsque les onglets en surbrillance ou sélectionnés dans une fenêtre changent. Déconseillé : utilisez tabs.onHighlighted à la place.
tabs.onHighlighted
Lancé lorsque les onglets en surbrillance ou sélectionnés dans une fenêtre changent.
tabs.onMoved
Lancé lorsqu'un onglet est déplacé dans une fenêtre.
tabs.onRemoved
Lancé lorsqu'un onglet est fermé.
tabs.onReplaced
Lancé lorsqu'un onglet est remplacé par un autre onglet en raison d'un prérendering.
tabs.onSelectionChanged
Se déclenche lorsque l'onglet sélectionné dans une fenêtre change. Déconseillé : utilisez tabs.onActivated à la place.
tabs.onUpdated
Lancé lorsqu'un onglet est mis à jour.
tabs.onZoomChange
Envoyé lorsqu'un onglet est agrandi.

Compatibilité du navigateur

ChromeEdgeFirefoxFirefox for AndroidOpera
MutedInfo Oui Non47 Non Oui
MutedInfoReason Oui Non47 Non Oui
PageSettings Non Non56 Non Non
TAB_ID_NONE Oui Oui4554 Oui
TabStatus Oui Oui4554 Oui
WindowType Oui Oui4554 Oui
ZoomSettings Oui Non45 Non Oui
ZoomSettingsMode Oui Non45 Non Oui
ZoomSettingsScope Oui Non45 Non Oui
captureTab Non Non5959 Non
captureVisibleTab Oui *154754 Oui *
connect Oui Non4554 Oui
create Oui Oui4554 Oui
detectLanguage Oui Oui45 Non Oui
discard54 * Oui58 Non Oui *
duplicate Oui Non4754 Oui
executeScript Oui Oui43 *54 Oui
get Oui Oui4554 Oui
getAllInWindow Oui Non4554 Non
getCurrent Oui Oui4554 Oui
getSelected Oui Non Non Non Non
getZoom Oui Non45 Non Oui
getZoomSettings Oui Non45 Non Oui
hide Non Non59 * Non Non
highlight Oui Non Non Non Non
insertCSS Oui Oui4754 Oui
move Oui Non46 Non Oui
onActivated Oui Oui4554 Oui
onActiveChanged Oui Non Non Non Non
onAttached Oui154554 Oui
onCreated Oui Oui4554 Oui
onDetached Oui154554 Oui
onHighlightChanged Oui Non Non Non Non
onHighlighted Oui Non4554 Non
onMoved Oui Non45 Non Oui
onRemoved Oui Oui4554 Oui
onReplaced Oui Non Non Non Oui
onSelectionChanged Oui Non Non Non Non
onUpdated Oui Oui4554 Oui
onZoomChange Oui Non45 Non Oui
print Non Non56 Non Non
printPreview Non Non56 Non Non
query Oui Oui *4554 Oui
reload Oui Non4554 Oui
remove Oui Oui4554 Oui
removeCSS Non Non4954 Non
saveAsPDF Non Non56 * Non Non
sendMessage Oui Oui *4554 Oui
sendRequest Oui Non Non Non Non
setZoom Oui Non45 Non Oui
setZoomSettings Oui Non Non Non Oui
show Non Non59 * Non Non
toggleReaderMode Non Non58 Non Non
update Oui Oui4554 Oui

Example extensions

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, Rik, Ostefanini, Sheppy
Dernière mise à jour par : hellosct1,