tabs

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:

• Pour accéder à Tab.url, Tab.title, and Tab.favIconUrl, vous devez avoir la permission "onglets". Dans Firefox, cela signifie également que vous avez besoin des "onglets" pour query par URL.

• Pour utiliser tabs.executeScript() ou tabs.insertCSS(), vous devez avoir les permission d'accueil pour l'onglet.

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

Example extensions

• annotate-page
• apply-css
• beastify
• bookmark-it
• chill-out
• commands
• context-menu-copy-link-with-types
• contextual-identities
• cookie-bg-picker
• devtools-panels
• find-across-tabs
• firefox-code-search
• history-deleter
• imagify
• list-cookies
• menu-demo
• menu-labelled-open
• open-my-page-button
• permissions
• react-es6-popup
• session-state
• store-collected-images
• tabs-tabs-tabs

// Copyright 2015 The Chromium Authors. All rights reserved.
//
// Redistribution and use in source and binary forms, with or without
// modification, are permitted provided that the following conditions are
// met:
//
//    * Redistributions of source code must retain the above copyright
// notice, this list of conditions and the following disclaimer.
//    * Redistributions in binary form must reproduce the above
// copyright notice, this list of conditions and the following disclaimer
// in the documentation and/or other materials provided with the
// distribution.
//    * Neither the name of Google Inc. nor the names of its
// contributors may be used to endorse or promote products derived from
// this software without specific prior written permission.
//
// THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
// "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
// LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
// A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
// OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
// SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
// LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
// DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
// THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
// (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
// OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.