Les extensions Manifest V2 ont été supprimées du Chrome Web Store le 31 août 2026. Migrez votre extension vers Manifest V3 pour qu'elle soit de nouveau disponible pour les utilisateurs.

Google utilise la technologie IA pour traduire le contenu dans votre langue préférée. Les traductions générées par IA peuvent contenir des erreurs.

chrome.tabs

refresh date: 2026-09-25 robots: noindex

Description

Utilisez l'API chrome.tabs pour interagir avec le système d'onglets du navigateur. Vous pouvez utiliser cette API pour créer, modifier et réorganiser les onglets dans le navigateur.

Présentation

L'API Tabs offre non seulement des fonctionnalités permettant de manipuler et de gérer les onglets, mais elle peut également détecter la langue de l'onglet, prendre une capture d'écran et communiquer avec les scripts de contenu d'un onglet.

Autorisations

La plupart des fonctionnalités ne nécessitent aucune autorisation. Par exemple : créer un onglet, recharger un onglet, accéder à une autre URL, etc.

Les développeurs doivent connaître trois autorisations lorsqu'ils utilisent l'API Tabs.

Autorisation "tabs": Cette autorisation ne donne pas accès à l'espace de noms chrome.tabs. Au lieu de cela, elle permet à une extension d'appeler tabs.query() sur quatre propriétés sensibles des instances tabs.Tab : url, pendingUrl, title et favIconUrl.
Autorisations de l'hôte: autorisations d'hôte permettent à une extension de lire et d'interroger les quatre propriétés sensibles tabs.Tab d'un onglet correspondant. Ils peuvent également interagir directement avec les onglets correspondants à l'aide de méthodes telles que tabs.captureVisibleTab(), tabs.executeScript(), tabs.insertCSS() et tabs.removeCSS().
Autorisation "activeTab": activeTab accorde à une extension une autorisation d'hôte temporaire pour l'onglet actuel en réponse à un appel de l'utilisateur. Contrairement aux autorisations d'hôte, activeTab ne déclenche aucun avertissement.

Fichier manifeste

Voici des exemples de déclaration de chaque autorisation dans le fichier manifeste :

  {
    "name": "My extension",
    ...
    "permissions": [
      "tabs"
    ],
    ...
  }

  {
    "name": "My extension",
    ...
    "host_permissions": [
      "http://*/*",
      "https://*/*"
    ],
    ...
  }

  {
    "name": "My extension",
    ...
    "permissions": [
      "activeTab"
    ],
    ...
  }

Cas d'utilisation

Les sections suivantes présentent quelques cas d'utilisation courants.

Ouverture d'une page d'extension dans un nouvel onglet

Un modèle courant pour les extensions consiste à ouvrir une page d'intégration dans un nouvel onglet lorsque l'extension est installée. L'exemple suivant montre comment procéder.

background.js:

chrome.runtime.onInstalled.addListener(({reason}) => {
  if (reason === 'install') {
    chrome.tabs.create({
      url: "onboarding.html"
    });
  }
});

Obtenir l'onglet actuel

Cet exemple montre comment le service worker d'une extension peut récupérer l'onglet actif de la fenêtre actuellement sélectionnée (ou de la fenêtre sélectionnée le plus récemment, si aucune fenêtre Chrome n'est sélectionnée). Il s'agit généralement de l'onglet actuel de l'utilisateur.

  async function getCurrentTab() {
    let queryOptions = { active: true, lastFocusedWindow: true };
    // `tab` will either be a `tabs.Tab` instance or `undefined`.
    let [tab] = await chrome.tabs.query(queryOptions);
    return tab;
  }

  function getCurrentTab(callback) {
    let queryOptions = { active: true, lastFocusedWindow: true };
    chrome.tabs.query(queryOptions, ([tab]) => {
      if (chrome.runtime.lastError)
      console.error(chrome.runtime.lastError);
      // `tab` will either be a `tabs.Tab` instance or `undefined`.
      callback(tab);
    });
  }

Couper le son de l'onglet spécifié

Cet exemple montre comment une extension peut activer ou désactiver le son d'un onglet donné.

  async function toggleMuteState(tabId) {
    const tab = await chrome.tabs.get(tabId);
    const muted = !tab.mutedInfo.muted;
    await chrome.tabs.update(tabId, {muted});
    console.log(`Tab ${tab.id} is ${muted ? "muted" : "unmuted"}`);
  }

  function toggleMuteState(tabId) {
    chrome.tabs.get(tabId, async (tab) => {
      let muted = !tab.mutedInfo.muted;
      await chrome.tabs.update(tabId, { muted });
      console.log(`Tab ${tab.id} is ${ muted ? "muted" : "unmuted" }`);
    });
  }

Déplacer l'onglet actuel vers la première position lorsque l'utilisateur clique dessus

Cet exemple montre comment déplacer un onglet, qu'un glissement soit en cours ou non. Bien que cet exemple utilise chrome.tabs.move, vous pouvez utiliser le même modèle d'attente pour d'autres appels qui modifient les onglets pendant qu'un glissement est en cours.

  chrome.tabs.onActivated.addListener(moveToFirstPosition);

  async function moveToFirstPosition(activeInfo) {
    try {
      await chrome.tabs.move(activeInfo.tabId, {index: 0});
      console.log("Success.");
    } catch (error) {
      if (error == "Error: Tabs cannot be edited right now (user may be dragging a tab).") {
        setTimeout(() => moveToFirstPosition(activeInfo), 50);
      } else {
        console.error(error);
      }
    }
  }

  chrome.tabs.onActivated.addListener(moveToFirstPositionMV2);

  function moveToFirstPositionMV2(activeInfo) {
    chrome.tabs.move(activeInfo.tabId, { index: 0 }, () => {
      if (chrome.runtime.lastError) {
        const error = chrome.runtime.lastError;
        if (error == "Error: Tabs cannot be edited right now (user may be dragging a tab).") {
          setTimeout(() => moveToFirstPositionMV2(activeInfo), 50);
        } else {
          console.error(error);
        }
      } else {
        console.log("Success.");
      }
    });
  }

Transmettre un message au script de contenu d'un onglet sélectionné

Cet exemple montre comment le service worker d'une extension peut communiquer avec des scripts de contenu dans des onglets de navigateur spécifiques à l'aide de tabs.sendMessage().

function sendMessageToActiveTab(message) {
  const [tab] = await chrome.tabs.query({ active: true, lastFocusedWindow: true });
  const response = await chrome.tabs.sendMessage(tab.id, message);
  // TODO: Do something with the response.
}

Exemples d'extensions

Pour découvrir d'autres démonstrations d'extensions de l'API Tabs, consultez l'une des ressources suivantes :

Types

MutedInfo

Chrome 46 ou version ultérieure

État de coupure du son de l'onglet et raison du dernier changement d'état.

Propriétés

extensionId

chaîne facultatif

ID de l'extension qui a modifié l'état de coupure du son. Non défini si une extension n'est pas à l'origine de la dernière modification de l'état de coupure du son.
son coupé

booléen

Indique si le son de l'onglet est coupé (empêche la lecture du son). Le son de l'onglet peut être coupé même s'il n'a pas diffusé ou ne diffuse pas de son actuellement. Équivaut à l'affichage de l'indicateur audio "coupé".
reason

MutedInfoReason facultatif

Raison pour laquelle le son de l'onglet a été coupé ou réactivé. Non défini si l'état de coupure du son de l'onglet n'a jamais été modifié.

MutedInfoReason

Chrome 46 ou version ultérieure

Événement ayant entraîné un changement d'état de coupure du son.

Énumération

"user"
Une action de saisie de l'utilisateur a défini l'état "coupé".

"capture"
La capture de l'onglet a commencé, ce qui a forcé un changement d'état de coupure du son.

"extension"
Une extension, identifiée par le champ extensionId, a défini l'état de coupure du son.

Tab

Propriétés

actif

booléen

Indique si l'onglet est actif dans sa fenêtre. Cela ne signifie pas nécessairement que la fenêtre est sélectionnée.
audible

boolean facultatif

Chrome 45 ou version ultérieure

Indique si l'onglet a produit du son au cours des deux dernières secondes (mais il est possible qu'il ne soit pas entendu s'il est également coupé). Équivaut à l'affichage ou non de l'indicateur "audio du haut-parleur".
autoDiscardable

booléen

Chrome 54 ou version ultérieure

Indique si l'onglet peut être supprimé automatiquement par le navigateur lorsque les ressources sont faibles.
avez supprimé

booléen

Chrome 54 ou version ultérieure

Indique si l'onglet est supprimé. Un onglet supprimé est un onglet dont le contenu a été déchargé de la mémoire, mais qui est toujours visible dans la barre d'onglets. Son contenu est actualisé lors de sa prochaine activation.
favIconUrl

chaîne facultatif

URL du favicon de l'onglet. Cette propriété n'est présente que si l'extension dispose de l'autorisation "tabs" ou d'autorisations d'hôte pour la page. Il peut également s'agir d'une chaîne vide si l'onglet est en cours de chargement.
figé

booléen

Chrome 132 ou version ultérieure

Indique si l'onglet est figé. Un onglet figé ne peut pas exécuter de tâches, y compris les gestionnaires d'événements ou les minuteurs. Il est visible dans la bande d'onglets et son contenu est chargé en mémoire. Il est débloqué lors de l'activation.
groupId

nombre

Chrome 88 ou version ultérieure

ID du groupe auquel appartient l'onglet.
height

number facultatif

Hauteur de l'onglet en pixels.
en surbrillance

booléen

Indique si l'onglet est mis en surbrillance.
id

number facultatif

ID de l'onglet. Les ID d'onglet sont uniques au sein d'une session de navigateur. Dans certains cas, il est possible qu'aucun ID ne soit attribué à un onglet, par exemple lors de l'interrogation d'onglets étrangers à l'aide de l'API sessions. Dans ce cas, un ID de session peut être présent. L'ID d'onglet peut également être défini sur chrome.tabs.TAB_ID_NONE pour les applications et les fenêtres des outils de développement.
navigation privée

booléen

Indique si l'onglet se trouve dans une fenêtre de navigation privée.
index

nombre

Index basé sur zéro de l'onglet dans sa fenêtre.
lastAccessed

nombre

Chrome 121 ou version ultérieure

Dernière fois que l'onglet est devenu actif dans sa fenêtre, en millisecondes depuis l'epoch.
mutedInfo

MutedInfo facultatif

Chrome 46 ou version ultérieure

État de coupure du son de l'onglet et raison du dernier changement d'état.
openerTabId

number facultatif

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.
pendingUrl

chaîne facultatif

Chrome 79 ou version ultérieure

URL vers laquelle l'onglet navigue, avant qu'il ne soit validé. Cette propriété n'est présente que si l'extension dispose de l'autorisation "tabs" ou d'autorisations d'hôte pour la page, et qu'une navigation est en attente.
épinglé

booléen

Indique si l'onglet est épinglé.
sélectionné

booléen

Obsolète

Veuillez utiliser tabs.Tab.highlighted.
Indique si l'onglet est sélectionné.
sessionId

chaîne facultatif

ID de session permettant d'identifier de manière unique un onglet obtenu à partir de l'API sessions.
splitViewId

number facultatif

Chrome 140 ou version ultérieure

ID de la vue fractionnée à laquelle appartient l'onglet.
état

TabStatus facultatif

État de chargement de l'onglet.
titre

chaîne facultatif

Titre de l'onglet. Cette propriété n'est présente que si l'extension dispose de l'autorisation "tabs" ou d'autorisations d'hôte pour la page.
url

chaîne facultatif

Dernière URL validée du frame principal de l'onglet. Cette propriété n'est présente que si l'extension dispose de l'autorisation "tabs" ou d'autorisations d'hôte pour la page. Il peut s'agir d'une chaîne vide si l'onglet n'a pas encore été validé. Voir aussi Tab.pendingUrl.
width

number facultatif

Largeur de l'onglet en pixels.
windowId

nombre

ID de la fenêtre contenant l'onglet.

TabStatus

Chrome 44 ou version ultérieure

État de chargement de l'onglet.

Énumération

"unloaded"

"loading"

"complete"

WindowType

Chrome 44 ou version ultérieure

Type de fenêtre.

Énumération

"normal"

"popup"

"panel"

"app"

"devtools"

ZoomSettings

Définit la manière dont les modifications du zoom dans un onglet sont gérées et à quel niveau.

Propriétés

defaultZoomFactor

number facultatif

Chrome 43 ou version ultérieure

Utilisé pour renvoyer le niveau de zoom par défaut de l'onglet actuel dans les appels à tabs.getZoomSettings.
mode

ZoomSettingsMode facultatif

Définit la manière dont les modifications du niveau de zoom sont gérées, c'est-à-dire l'entité responsable de la mise à l'échelle de la page. La valeur par défaut est automatic.
champ d'application

ZoomSettingsScope facultatif

Définit si les modifications du zoom sont conservées pour l'origine de la page ou si elles ne s'appliquent qu'à cet onglet. La valeur par défaut est per-origin en mode automatic, et per-tab dans les autres cas.

ZoomSettingsMode

Chrome 44 ou version ultérieure

Définit la manière dont les modifications du niveau de zoom sont gérées, c'est-à-dire l'entité responsable de la mise à l'échelle de la page. La valeur par défaut est automatic.

Énumération

"automatic"
Les modifications du niveau de zoom sont gérées automatiquement par le navigateur.

"manual"
Remplace la gestion automatique des changements de zoom. L'événement onZoomChange sera toujours distribué, et il incombe à l'extension d'écouter cet événement et de redimensionner manuellement la page. Ce mode n'est pas compatible avec le zoom per-origin. Il ignore donc le paramètre de zoom scope et suppose per-tab.

"disabled"
Désactive tout zoom dans l'onglet. L'onglet revient au niveau de zoom par défaut, et toutes les tentatives de modification du zoom sont ignorées.

ZoomSettingsScope

Chrome 44 ou version ultérieure

Définit si les modifications du zoom sont conservées pour l'origine de la page ou si elles ne s'appliquent qu'à cet onglet. La valeur par défaut est per-origin en mode automatic, et per-tab dans les autres cas.

Énumération

"per-origin"
Les modifications du zoom sont conservées dans l'origine de la page zoomée, c'est-à-dire que tous les autres onglets accédant à cette même origine sont également zoomés. De plus, les modifications du zoom per-origin sont enregistrées avec l'origine, ce qui signifie que lorsque vous accédez à d'autres pages de la même origine, elles sont toutes zoomées avec le même facteur de zoom. Le champ d'application per-origin n'est disponible qu'en mode automatic.

"per-tab"
Les modifications du niveau de zoom ne prennent effet que dans cet onglet, et les modifications du niveau de zoom dans d'autres onglets n'affectent pas le niveau de zoom de cet onglet. De plus, les modifications du zoom per-tab sont réinitialisées lors de la navigation. La navigation dans un onglet charge toujours les pages avec leurs facteurs de zoom per-origin.

Propriétés

MAX_CAPTURE_VISIBLE_TAB_CALLS_PER_SECOND

Chrome 92 ou version ultérieure

Nombre maximal de fois où captureVisibleTab peut être appelé par seconde. captureVisibleTab est coûteux et ne doit pas être appelé trop souvent.

Valeur

SPLIT_VIEW_ID_NONE

Chrome 140 ou version ultérieure

ID représentant l'absence d'onglet partagé.

Valeur

-1

TAB_ID_NONE

Chrome 46 ou version ultérieure

ID représentant l'absence d'un onglet de navigateur.

Valeur

-1

TAB_INDEX_NONE

Chrome 123 ou version ultérieure

Index représentant l'absence d'un index d'onglet dans une barre d'onglets.

Valeur

-1

Méthodes

captureVisibleTab()

Promise

chrome.tabs.captureVisibleTab(
  windowId?: number,
  options?: ImageDetails,
  callback?: function,
): Promise<string>

Capture la zone visible de l'onglet actuellement actif dans la fenêtre spécifiée. Pour appeler cette méthode, l'extension doit disposer de l'autorisation <all_urls> ou activeTab. En plus des sites auxquels les extensions peuvent normalement accéder, cette méthode permet aux extensions de capturer des sites sensibles qui sont normalement restreints, y compris les pages du schéma chrome:, les pages d'autres extensions et les URL data:. Ces sites sensibles ne peuvent être capturés qu'avec l'autorisation activeTab. Les URL de fichiers ne peuvent être capturées que si l'extension a été autorisée à accéder aux fichiers.

Paramètres

windowId

number facultatif

La fenêtre cible. La valeur par défaut est la fenêtre actuelle.
options

ImageDetails facultatif
callback

function facultatif

Le paramètre callback se présente comme suit :
```
(dataUrl: string) => void
```
- dataUrl
  
  chaîne
  
  URL de données qui encode une image de la zone visible de l'onglet capturé. Peut être attribué à la propriété "src" d'un élément HTML img pour l'affichage.

Renvoie

Promise<string>

Chrome 88 ou version ultérieure

Les promesses ne sont compatibles qu'avec Manifest V3 et les versions ultérieures. Les autres plates-formes doivent utiliser des rappels.

connect()

chrome.tabs.connect(
  tabId: number,
  connectInfo?: object,
): runtime.Port

Se connecte aux scripts de contenu de l'onglet spécifié. L'événement runtime.onConnect est déclenché dans chaque script de contenu exécuté dans l'onglet spécifié pour l'extension actuelle. Pour en savoir plus, consultez Messagerie de script de contenu.

Paramètres

tabId

nombre
connectInfo

objet facultatif
- documentId
  
  chaîne facultatif
  
  Chrome 106 ou version ultérieure
  
  Ouvre un port vers un document spécifique identifié par documentId au lieu de tous les cadres de l'onglet.
- frameId
  
  number facultatif
  
  Ouvrez un port vers un frame spécifique identifié par frameId au lieu de tous les frames de l'onglet.
- nom
  
  chaîne facultatif
  
  Est transmis à onConnect pour les scripts de contenu qui écoutent l'événement de connexion.

Renvoie

runtime.Port

Port pouvant être utilisé pour communiquer avec les scripts de contenu exécutés dans l'onglet spécifié. L'événement runtime.Port du port est déclenché si l'onglet se ferme ou n'existe pas.

create()

Promise

chrome.tabs.create(
  createProperties: object,
  callback?: function,
): Promise<Tab>

Crée un onglet.

Paramètres

createProperties

objet
- actif
  
  boolean facultatif
  
  Indique si l'onglet doit devenir l'onglet actif de la fenêtre. N'affecte pas la sélection de la fenêtre (voir windows.update). La valeur par défaut est true.
- index
  
  number facultatif
  
  Position que l'onglet doit prendre dans la fenêtre. La valeur fournie est limitée à une valeur comprise entre zéro et le nombre d'onglets dans la fenêtre.
- openerTabId
  
  number facultatif
  
  ID de l'onglet qui a ouvert cet onglet. S'il est spécifié, l'onglet d'ouverture doit se trouver dans la même fenêtre que l'onglet nouvellement créé.
- épinglé
  
  boolean facultatif
  
  Indique si l'onglet doit être épinglé. La valeur par défaut est false.
- sélectionné
  
  boolean facultatif
  
  Obsolète
  
  Veuillez utiliser active.
  Indique si l'onglet doit devenir l'onglet sélectionné dans la fenêtre. La valeur par défaut est true.
- splitWithTabId
  
  number facultatif
  
  Chrome 155 ou version ultérieure
  
  ID d'un onglet existant avec lequel créer une vue fractionnée. S'il est spécifié, l'onglet de fractionnement doit remplir les conditions suivantes :
  - Il ne doit pas s'agir d'un onglet déjà scindé.
  - Il doit se trouver dans la même fenêtre que l'onglet que vous venez de créer.
  - Si windowId est spécifié, il doit être identique à l'ID de la fenêtre de l'onglet de division.
  - Si index est spécifié, il doit s'agir d'un index adjacent à l'onglet de division et il affectera l'emplacement relatif de l'onglet nouvellement créé.
- url
  
  chaîne facultatif
  
  URL vers laquelle l'onglet doit initialement naviguer. Les URL complètes doivent inclure un schéma (par exemple, "http://www.google.com", et non "www.google.com"). Les URL relatives sont relatives à la page actuelle dans l'extension. La page "Nouvel onglet" est définie par défaut.
- windowId
  
  number facultatif
  
  Fenêtre dans laquelle créer l'onglet. La valeur par défaut est la fenêtre actuelle.
callback

function facultatif

Le paramètre callback se présente comme suit :
```
(tab: Tab) => void
```
- tabulation
  
  Tabulation
  
  L'onglet créé.

Renvoie

Promise<Tab>

Chrome 88 ou version ultérieure

Les promesses ne sont compatibles qu'avec Manifest V3 et les versions ultérieures. Les autres plates-formes doivent utiliser des rappels.

createSplit()

Promise Chrome 155+

chrome.tabs.createSplit(
  tabIds: [number, number],
  callback?: function,
): Promise<number>

Divise deux onglets existants en une vue fractionnée.

Paramètres

tabIds

[number, number]

Un tableau contenant exactement deux ID d'onglets à associer dans une vue fractionnée. Tous les onglets doivent remplir les conditions suivantes :

Ils doivent être adjacents. Elles ne doivent pas déjà être en vue fractionnée. Ils doivent avoir des états windowId, pinned et groupId correspondants.
callback

function facultatif

Le paramètre callback se présente comme suit :
```
(splitViewId: number) => void
```
- splitViewId
  
  nombre
  
  ID de la vue fractionnée récemment créée contenant les onglets spécifiés.

Renvoie

Promise<number>

Les promesses ne sont compatibles qu'avec Manifest V3 et les versions ultérieures. Les autres plates-formes doivent utiliser des rappels.

detectLanguage()

Promise

chrome.tabs.detectLanguage(
  tabId?: number,
  callback?: function,
): Promise<string>

Détecte la langue principale du contenu d'un onglet.

Paramètres

tabId

number facultatif

La valeur par défaut est l'onglet actif de la fenêtre actuelle.
callback

function facultatif

Le paramètre callback se présente comme suit :
```
(language: string) => void
```
- language
  
  chaîne
  
  Code de langue ISO, tel que en ou fr. Pour obtenir la liste complète des langues compatibles avec cette méthode, consultez kLanguageInfoTable. Les colonnes 2 à 4 sont vérifiées, et la première valeur non NULL est renvoyée, sauf pour le chinois simplifié, pour lequel zh-CN est renvoyé. Pour une langue inconnue/non définie, und est renvoyé.

Renvoie

Promise<string>

Chrome 88 ou version ultérieure

Les promesses ne sont compatibles qu'avec Manifest V3 et les versions ultérieures. Les autres plates-formes doivent utiliser des rappels.

discard()

Promise Chrome 54 et versions ultérieures

chrome.tabs.discard(
  tabId?: number,
  callback?: function,
): Promise<Tab | undefined>

Supprime un onglet de la mémoire. Les onglets supprimés restent visibles dans la bande d'onglets et sont actualisés lorsqu'ils sont activés.

Paramètres

tabId

number facultatif

ID de l'onglet à supprimer. Si cette option est spécifiée, l'onglet est supprimé, sauf s'il est actif ou s'il a déjà été supprimé. Si cette option est omise, le navigateur supprime l'onglet le moins important. Cette opération peut échouer si aucun onglet supprimable n'existe.
callback

function facultatif

Le paramètre callback se présente comme suit :
```
(tab?: Tab) => void
```
- tabulation
  
  Tab facultatif
  
  Onglet supprimé, s'il a bien été supprimé, ou "undefined" dans le cas contraire.

Renvoie

Promise<Tab | undefined>

Chrome 88 ou version ultérieure

Se résout une fois l'opération terminée.

Les promesses ne sont compatibles qu'avec Manifest V3 et les versions ultérieures. Les autres plates-formes doivent utiliser des rappels.

duplicate()

Promise

chrome.tabs.duplicate(
  tabId: number,
  callback?: function,
): Promise<Tab | undefined>

Duplique un onglet.

Paramètres

tabId

nombre

ID de l'onglet à dupliquer.
callback

function facultatif

Le paramètre callback se présente comme suit :
```
(tab?: Tab) => void
```
- tabulation
  
  Tab facultatif
  
  Détails sur l'onglet dupliqué. Les propriétés url, pendingUrl, title et favIconUrl ne sont incluses dans l'objet tabs.Tab que si l'extension dispose de l'autorisation "tabs" ou d'autorisations d'hôte pour la page.

Renvoie

Promise<Tab | undefined>

Chrome 88 ou version ultérieure

Les promesses ne sont compatibles qu'avec Manifest V3 et les versions ultérieures. Les autres plates-formes doivent utiliser des rappels.

executeScript()

Promise &leq; MV2 Obsolète depuis Chrome 91

chrome.tabs.executeScript(
  tabId?: number,
  details: InjectDetails,
  callback?: function,
): Promise<any[] | undefined>

Remplacé par scripting.executeScript dans Manifest V3.

Injecte du code JavaScript dans une page. Pour en savoir plus, consultez la section Injection programmatique de la documentation sur les scripts de contenu.

Paramètres

tabId

number facultatif

ID de l'onglet dans lequel exécuter le script. Par défaut, il s'agit de l'onglet actif de la fenêtre actuelle.
détails

InjectDetails

Détails du script à exécuter. Vous devez définir la propriété "code" ou "file", mais pas les deux en même temps.
callback

function facultatif

Le paramètre callback se présente comme suit :
```
(result?: any[]) => void
```
- résultat
  
  any[] facultatif
  
  Résultat du script dans chaque frame injecté.

Renvoie

Promise<any[] | undefined>

Chrome 88 ou version ultérieure

Se résout une fois que tout le code JavaScript a été exécuté.

Les promesses ne sont compatibles qu'avec Manifest V3 et les versions ultérieures. Les autres plates-formes doivent utiliser des rappels.

get()

Promise

chrome.tabs.get(
  tabId: number,
  callback?: function,
): Promise<Tab>

Récupère les détails de l'onglet spécifié.

Paramètres

tabId

nombre
callback

function facultatif

Le paramètre callback se présente comme suit :
```
(tab: Tab) => void
```
- tabulation
  
  Tabulation

Renvoie

Promise<Tab>

Chrome 88 ou version ultérieure

Les promesses ne sont compatibles qu'avec Manifest V3 et les versions ultérieures. Les autres plates-formes doivent utiliser des rappels.

getAllInWindow()

Promise &leq; MV2 Obsolète

chrome.tabs.getAllInWindow(
  windowId?: number,
  callback?: function,
): Promise<Tab[]>

Veuillez utiliser tabs.query {windowId: windowId}.

Récupère des informations sur tous les onglets de la fenêtre spécifiée.

Paramètres

windowId

number facultatif

La valeur par défaut est la fenêtre actuelle.
callback

function facultatif

Le paramètre callback se présente comme suit :
```
(tabs: Tab[]) => void
```
- tabs
  
  Tab[]

Renvoie

Promise<Tab[]>

Chrome 88 ou version ultérieure

Les promesses ne sont compatibles qu'avec Manifest V3 et les versions ultérieures. Les autres plates-formes doivent utiliser des rappels.

getCurrent()

Promise

chrome.tabs.getCurrent(
  callback?: function,
): Promise<Tab | undefined>

Récupère l'onglet à partir duquel cet appel de script est effectué. Renvoie undefined si l'appel est effectué depuis un contexte autre qu'un onglet (par exemple, une page d'arrière-plan ou une vue pop-up).

Paramètres

callback

function facultatif

Le paramètre callback se présente comme suit :
```
(tab?: Tab) => void
```
- tabulation
  
  Tab facultatif

Renvoie

Promise<Tab | undefined>

Chrome 88 ou version ultérieure

Les promesses ne sont compatibles qu'avec Manifest V3 et les versions ultérieures. Les autres plates-formes doivent utiliser des rappels.

getSelected()

Promise &leq; MV2 Obsolète

chrome.tabs.getSelected(
  windowId?: number,
  callback?: function,
): Promise<Tab>

Veuillez utiliser tabs.query {active: true}.

Récupère l'onglet sélectionné dans la fenêtre spécifiée.

Paramètres

windowId

number facultatif

La valeur par défaut est la fenêtre actuelle.
callback

function facultatif

Le paramètre callback se présente comme suit :
```
(tab: Tab) => void
```
- tabulation
  
  Tabulation

Renvoie

Promise<Tab>

Chrome 88 ou version ultérieure

Les promesses ne sont compatibles qu'avec Manifest V3 et les versions ultérieures. Les autres plates-formes doivent utiliser des rappels.

getZoom()

Promise

chrome.tabs.getZoom(
  tabId?: number,
  callback?: function,
): Promise<number>

Récupère le facteur de zoom actuel d'un onglet spécifié.

Paramètres

tabId

number facultatif

ID de l'onglet à partir duquel obtenir le facteur de zoom actuel. Par défaut, il s'agit de l'onglet actif de la fenêtre actuelle.
callback

function facultatif

Le paramètre callback se présente comme suit :
```
(zoomFactor: number) => void
```
- zoomFactor
  
  nombre
  
  Facteur de zoom actuel de l'onglet.

Renvoie

Promise<number>

Chrome 88 ou version ultérieure

Se résout avec le facteur de zoom actuel de l'onglet après sa récupération.

Les promesses ne sont compatibles qu'avec Manifest V3 et les versions ultérieures. Les autres plates-formes doivent utiliser des rappels.

getZoomSettings()

Promise

chrome.tabs.getZoomSettings(
  tabId?: number,
  callback?: function,
): Promise<ZoomSettings>

Récupère les paramètres de zoom actuels d'un onglet spécifié.

Paramètres

tabId

number facultatif

ID de l'onglet à partir duquel obtenir les paramètres de zoom actuels. La valeur par défaut est l'onglet actif de la fenêtre actuelle.
callback

function facultatif

Le paramètre callback se présente comme suit :
```
(zoomSettings: ZoomSettings) => void
```
- zoomSettings
  
  ZoomSettings
  
  Paramètres de zoom actuels de l'onglet.

Renvoie

Promise<ZoomSettings>

Chrome 88 ou version ultérieure

Se résout avec les paramètres de zoom actuels de l'onglet.

Les promesses ne sont compatibles qu'avec Manifest V3 et les versions ultérieures. Les autres plates-formes doivent utiliser des rappels.

goBack()

Promise Chrome 72+

chrome.tabs.goBack(
  tabId?: number,
  callback?: function,
): Promise<void>

Revenir à la page précédente, si elle est disponible.

Paramètres

tabId

number facultatif

ID de l'onglet auquel revenir. Par défaut, il s'agit de l'onglet sélectionné de la fenêtre actuelle.
callback

function facultatif

Le paramètre callback se présente comme suit :
```
() => void
```

Renvoie

Promise<void>

Chrome 88 ou version ultérieure

Les promesses ne sont compatibles qu'avec Manifest V3 et les versions ultérieures. Les autres plates-formes doivent utiliser des rappels.

goForward()

Promise Chrome 72+

chrome.tabs.goForward(
  tabId?: number,
  callback?: function,
): Promise<void>

Accéder à la page suivante, si elle est disponible.

Paramètres

tabId

number facultatif

ID de l'onglet vers lequel naviguer. Par défaut, il s'agit de l'onglet sélectionné de la fenêtre actuelle.
callback

function facultatif

Le paramètre callback se présente comme suit :
```
() => void
```

Renvoie

Promise<void>

Chrome 88 ou version ultérieure

Les promesses ne sont compatibles qu'avec Manifest V3 et les versions ultérieures. Les autres plates-formes doivent utiliser des rappels.

group()

Promise Chrome 88 et versions ultérieures

chrome.tabs.group(
  options: object,
  callback?: function,
): Promise<number>

Ajoute un ou plusieurs onglets à un groupe spécifié ou, si aucun groupe n'est spécifié, ajoute les onglets donnés à un groupe nouvellement créé.

Paramètres

options

objet
- createProperties
  
  objet facultatif
  
  Configurations pour créer un groupe. Ne peut pas être utilisé si groupId est déjà spécifié.
  - windowId
    
    number facultatif
    
    Fenêtre du nouveau groupe La valeur par défaut est la fenêtre actuelle.
- groupId
  
  number facultatif
  
  ID du groupe auquel ajouter les onglets. Si vous n'en spécifiez aucun, un groupe sera créé.
- tabIds
  
  number | [number, ...number[]]
  
  ID de l'onglet ou liste des ID d'onglets à ajouter au groupe spécifié.
callback

function facultatif

Le paramètre callback se présente comme suit :
```
(groupId: number) => void
```
- groupId
  
  nombre
  
  ID du groupe auquel les onglets ont été ajoutés.

Renvoie

Promise<number>

Les promesses ne sont compatibles qu'avec Manifest V3 et les versions ultérieures. Les autres plates-formes doivent utiliser des rappels.

highlight()

Promise

chrome.tabs.highlight(
  highlightInfo: object,
  callback?: function,
): Promise<windows.Window>

Met en surbrillance les onglets indiqués et sélectionne le premier du groupe. Semble n'avoir aucun effet si l'onglet spécifié est actuellement actif.

Paramètres

highlightInfo

objet
- tabs
  
  number | number[]
  
  Un ou plusieurs indices d'onglets à mettre en surbrillance.
- windowId
  
  number facultatif
  
  Fenêtre contenant les onglets.
callback

function facultatif

Le paramètre callback se présente comme suit :
```
(window: Window) => void
```
- fenêtre
  
  Fenêtre
  
  Contient des détails sur la fenêtre dont les onglets ont été mis en surbrillance.

Renvoie

Promise<windows.Window>

Chrome 88 ou version ultérieure

Les promesses ne sont compatibles qu'avec Manifest V3 et les versions ultérieures. Les autres plates-formes doivent utiliser des rappels.

insertCSS()

Promise &leq; MV2 Obsolète depuis Chrome 91

chrome.tabs.insertCSS(
  tabId?: number,
  details: InjectDetails,
  callback?: function,
): Promise<void>

Remplacé par scripting.insertCSS dans Manifest V3.

Insertion de CSS sur une page. Les styles insérés avec cette méthode peuvent être supprimés avec scripting.removeCSS. Pour en savoir plus, consultez la section Injection programmatique de la documentation sur les scripts de contenu.

Paramètres

tabId

number facultatif

ID de l'onglet dans lequel insérer le CSS. Par défaut, il s'agit de l'onglet actif de la fenêtre actuelle.
détails

InjectDetails

Détails du texte CSS à insérer. Vous devez définir la propriété "code" ou "file", mais pas les deux en même temps.
callback

function facultatif

Le paramètre callback se présente comme suit :
```
() => void
```

Renvoie

Promise<void>

Chrome 88 ou version ultérieure

Se résout lorsque tout le CSS a été inséré.

Les promesses ne sont compatibles qu'avec Manifest V3 et les versions ultérieures. Les autres plates-formes doivent utiliser des rappels.

move()

Promise

chrome.tabs.move(
  tabIds: number | number[],
  moveProperties: object,
  callback?: function,
): Promise<Tab | Tab[]>

Déplace un ou plusieurs onglets vers une nouvelle position dans sa fenêtre ou vers une nouvelle fenêtre. Notez que les onglets ne peuvent être déplacés que vers et depuis des fenêtres normales (window.type === "normal").

Paramètres

tabIds

number | number[]

ID de l'onglet ou liste des ID des onglets à déplacer.
moveProperties

objet
- index
  
  nombre
  
  Position vers laquelle déplacer la fenêtre. Utilisez -1 pour placer l'onglet à la fin de la fenêtre.
- windowId
  
  number facultatif
  
  La valeur par défaut est la fenêtre dans laquelle l'onglet se trouve actuellement.
callback

function facultatif

Le paramètre callback se présente comme suit :
```
(tabs: Tab | Tab[]) => void
```
- tabs
  
  Tab | Tab[]
  
  Détails sur les onglets déplacés.

Renvoie

Promise<Tab | Tab[]>

Chrome 88 ou version ultérieure

Les promesses ne sont compatibles qu'avec Manifest V3 et les versions ultérieures. Les autres plates-formes doivent utiliser des rappels.

query()

Promise

chrome.tabs.query(
  queryInfo: object,
  callback?: function,
): Promise<Tab[]>

Récupère tous les onglets qui possèdent les propriétés spécifiées, ou tous les onglets si aucune propriété n'est spécifiée.

Paramètres

queryInfo

objet
- actif
  
  boolean facultatif
  
  Indique si les onglets sont actifs dans leurs fenêtres.
- audible
  
  boolean facultatif
  
  Chrome 45 ou version ultérieure
  
  Indique si les onglets sont audibles.
- autoDiscardable
  
  boolean facultatif
  
  Chrome 54 ou version ultérieure
  
  Indique si les onglets peuvent être supprimés automatiquement par le navigateur lorsque les ressources sont faibles.
- currentWindow
  
  boolean facultatif
  
  Indique si les onglets se trouvent dans la fenêtre actuelle.
- avez supprimé
  
  boolean facultatif
  
  Chrome 54 ou version ultérieure
  
  Indique si les onglets sont supprimés. Un onglet supprimé est un onglet dont le contenu a été déchargé de la mémoire, mais qui est toujours visible dans la barre d'onglets. Son contenu est actualisé lors de sa prochaine activation.
- figé
  
  boolean facultatif
  
  Chrome 132 ou version ultérieure
  
  Indique si les onglets sont figés. Un onglet figé ne peut pas exécuter de tâches, y compris les gestionnaires d'événements ou les minuteurs. Il est visible dans la bande d'onglets et son contenu est chargé en mémoire. Il est débloqué lors de l'activation.
- groupId
  
  number facultatif
  
  Chrome 88 ou version ultérieure
  
  ID du groupe dans lequel se trouvent les onglets, ou tabGroups.TAB_GROUP_ID_NONE pour les onglets non regroupés.
- en surbrillance
  
  boolean facultatif
  
  Indique si les onglets sont mis en surbrillance.
- index
  
  number facultatif
  
  La position des onglets dans leurs fenêtres.
- lastFocusedWindow
  
  boolean facultatif
  
  Indique si les onglets se trouvent dans la dernière fenêtre sélectionnée.
- son coupé
  
  boolean facultatif
  
  Chrome 45 ou version ultérieure
  
  Indique si le son des onglets est coupé.
- épinglé
  
  boolean facultatif
  
  Indique si les onglets sont épinglés.
- splitViewId
  
  number facultatif
  
  Chrome 140 ou version ultérieure
  
  ID de la vue fractionnée dans laquelle se trouvent les onglets, ou tabs.SPLIT_VIEW_ID_NONE pour les onglets qui ne se trouvent pas dans une vue fractionnée.
- état
  
  TabStatus facultatif
  
  État de chargement de l'onglet.
- titre
  
  chaîne facultatif
  
  Mettre en correspondance les titres de la page avec un format. Cette propriété est ignorée si l'extension ne dispose pas de l'autorisation "tabs" ou des autorisations d'hôte pour la page.
- url
  
  string | string[] facultatif
  
  Faites correspondre les onglets à un ou plusieurs formats d'URL. Les identificateurs de fragments ne sont pas mis en correspondance. Cette propriété est ignorée si l'extension ne dispose pas de l'autorisation "tabs" ou des autorisations d'hôte pour la page.
- windowId
  
  number facultatif
  
  ID de la fenêtre parente, ou windows.WINDOW_ID_CURRENT pour la fenêtre actuelle.
- windowType
  
  WindowType facultatif
  
  Type de fenêtre dans laquelle se trouvent les onglets.
callback

function facultatif

Le paramètre callback se présente comme suit :
```
(result: Tab[]) => void
```
- résultat
  
  Tab[]

Renvoie

Promise<Tab[]>

Chrome 88 ou version ultérieure

Les promesses ne sont compatibles qu'avec Manifest V3 et les versions ultérieures. Les autres plates-formes doivent utiliser des rappels.

reload()

Promise

chrome.tabs.reload(
  tabId?: number,
  reloadProperties?: object,
  callback?: function,
): Promise<void>

Actualiser un onglet

Paramètres

tabId

number facultatif

ID de l'onglet à actualiser. Par défaut, il s'agit de l'onglet sélectionné de la fenêtre actuelle.
reloadProperties

objet facultatif
- bypassCache
  
  boolean facultatif
  
  Indique si la mise en cache locale doit être ignorée. La valeur par défaut est false.
callback

function facultatif

Le paramètre callback se présente comme suit :
```
() => void
```

Renvoie

Promise<void>

Chrome 88 ou version ultérieure

Les promesses ne sont compatibles qu'avec Manifest V3 et les versions ultérieures. Les autres plates-formes doivent utiliser des rappels.

remove()

Promise

chrome.tabs.remove(
  tabIds: number | number[],
  callback?: function,
): Promise<void>

Ferme un ou plusieurs onglets.

Paramètres

tabIds

number | number[]

ID de l'onglet ou liste des ID des onglets à fermer.
callback

function facultatif

Le paramètre callback se présente comme suit :
```
() => void
```

Renvoie

Promise<void>

Chrome 88 ou version ultérieure

Les promesses ne sont compatibles qu'avec Manifest V3 et les versions ultérieures. Les autres plates-formes doivent utiliser des rappels.

removeCSS()

Promise Chrome 87 et versions ultérieures &leq; MV2 Obsolète depuis Chrome 91

chrome.tabs.removeCSS(
  tabId?: number,
  details: DeleteInjectionDetails,
  callback?: function,
): Promise<void>

Remplacé par scripting.removeCSS dans Manifest V3.

Supprime d'une page le code CSS précédemment injecté par un appel à scripting.insertCSS.

Paramètres

tabId

number facultatif

ID de l'onglet duquel supprimer le CSS. Par défaut, il s'agit de l'onglet actif de la fenêtre actuelle.
détails

DeleteInjectionDetails

Détails du texte CSS à supprimer. Vous devez définir la propriété "code" ou "file", mais pas les deux en même temps.
callback

function facultatif

Le paramètre callback se présente comme suit :
```
() => void
```

Renvoie

Promise<void>

Chrome 88 ou version ultérieure

Se résout lorsque tout le CSS a été supprimé.

Les promesses ne sont compatibles qu'avec Manifest V3 et les versions ultérieures. Les autres plates-formes doivent utiliser des rappels.

sendMessage()

Promise

chrome.tabs.sendMessage(
  tabId: number,
  message: any,
  options?: object,
  callback?: function,
): Promise<any>

Envoie un seul message aux scripts de contenu de l'onglet spécifié. L'événement runtime.onMessage est déclenché dans chaque script de contenu exécuté dans l'onglet spécifié pour l'extension actuelle.

Paramètres

tabId

nombre
message

tous

Message à envoyer. Ce message doit être un objet JSON-ifiable.
options

objet facultatif
- documentId
  
  chaîne facultatif
  
  Chrome 106 ou version ultérieure
  
  Envoyez un message à un document spécifique identifié par documentId au lieu de tous les cadres de l'onglet.
- frameId
  
  number facultatif
  
  Envoyez un message à un frame spécifique identifié par frameId au lieu de tous les frames de l'onglet.
callback

function facultatif

Chrome 99 ou version ultérieure

Le paramètre callback se présente comme suit :
```
(response: any) => void
```
- réponse
  
  tous
  
  Objet de réponse JSON envoyé par le gestionnaire du message.

Renvoie

Promise<any>

Chrome 99 ou version ultérieure

Promesse qui se résout avec la réponse du script de contenu. Si une erreur se produit lors de la connexion à l'onglet spécifié, la promesse sera rejetée.

Les promesses ne sont compatibles qu'avec Manifest V3 et les versions ultérieures. Les autres plates-formes doivent utiliser des rappels.

sendRequest()

Promise &leq; MV2 Obsolète

chrome.tabs.sendRequest(
  tabId: number,
  request: any,
  callback?: function,
): Promise<any>

Veuillez utiliser runtime.sendMessage.

Envoie une seule requête aux scripts de contenu de l'onglet spécifié, avec un rappel facultatif à exécuter lorsqu'une réponse est renvoyée. L'événement extension.onRequest est déclenché dans chaque script de contenu exécuté dans l'onglet spécifié pour l'extension actuelle.

Paramètres

tabId

nombre
request

tous
callback

function facultatif

Chrome 99 ou version ultérieure

Le paramètre callback se présente comme suit :
```
(response: any) => void
```
- réponse
  
  tous
  
  Objet de réponse JSON envoyé par le gestionnaire de la requête. Si une erreur se produit lors de la connexion à l'onglet spécifié, la promesse sera rejetée.

Renvoie

Promise<any>

Chrome 99 ou version ultérieure

Les promesses ne sont compatibles qu'avec Manifest V3 et les versions ultérieures. Les autres plates-formes doivent utiliser des rappels.

setZoom()

Promise

chrome.tabs.setZoom(
  tabId?: number,
  zoomFactor: number,
  callback?: function,
): Promise<void>

Effectue un zoom sur un onglet spécifié.

Paramètres

tabId

number facultatif

ID de l'onglet à zoomer. Par défaut, il s'agit de l'onglet actif de la fenêtre actuelle.
zoomFactor

nombre

Nouveau facteur de zoom. La valeur 0 définit l'onglet sur son facteur de zoom par défaut actuel. Les valeurs supérieures à 0 spécifient un facteur de zoom (éventuellement différent de celui par défaut) pour l'onglet.
callback

function facultatif

Le paramètre callback se présente comme suit :
```
() => void
```

Renvoie

Promise<void>

Chrome 88 ou version ultérieure

Se résout une fois que le facteur de zoom a été modifié.

Les promesses ne sont compatibles qu'avec Manifest V3 et les versions ultérieures. Les autres plates-formes doivent utiliser des rappels.

setZoomSettings()

Promise

chrome.tabs.setZoomSettings(
  tabId?: number,
  zoomSettings: ZoomSettings,
  callback?: function,
): Promise<void>

Définit les paramètres de zoom d'un onglet spécifié, qui déterminent la façon dont les modifications de zoom sont gérées. Ces paramètres sont réinitialisés lorsque vous quittez l'onglet.

Paramètres

tabId

number facultatif

ID de l'onglet dont vous souhaitez modifier les paramètres de zoom. Par défaut, il s'agit de l'onglet actif de la fenêtre actuelle.
zoomSettings

ZoomSettings

Définit la manière dont les modifications du zoom sont gérées et à quel niveau.
callback

function facultatif

Le paramètre callback se présente comme suit :
```
() => void
```

Renvoie

Promise<void>

Chrome 88 ou version ultérieure

Se résout une fois les paramètres de zoom modifiés.

Les promesses ne sont compatibles qu'avec Manifest V3 et les versions ultérieures. Les autres plates-formes doivent utiliser des rappels.

ungroup()

Promise Chrome 88 et versions ultérieures

chrome.tabs.ungroup(
  tabIds: number | [number, ...number[]],
  callback?: function,
): Promise<void>

Supprime un ou plusieurs onglets de leurs groupes respectifs. Si des groupes deviennent vides, ils sont supprimés.

Paramètres

tabIds

number | [number, ...number[]]

ID de l'onglet ou liste des ID des onglets à supprimer de leurs groupes respectifs.
callback

function facultatif

Le paramètre callback se présente comme suit :
```
() => void
```

Renvoie

Promise<void>

Les promesses ne sont compatibles qu'avec Manifest V3 et les versions ultérieures. Les autres plates-formes doivent utiliser des rappels.

unsplit()

Promise Chrome 155+

chrome.tabs.unsplit(
  splitViewId: number,
  callback?: function,
): Promise<void>

Sépare les onglets d'une vue fractionnée en onglets indépendants.

Paramètres

splitViewId

nombre

ID de la vue fractionnée à séparer.
callback

function facultatif

Le paramètre callback se présente comme suit :
```
() => void
```

Renvoie

Promise<void>

Les promesses ne sont compatibles qu'avec Manifest V3 et les versions ultérieures. Les autres plates-formes doivent utiliser des rappels.

update()

Promise

chrome.tabs.update(
  tabId?: number,
  updateProperties: object,
  callback?: function,
): Promise<Tab | undefined>

Modifie les propriétés d'un onglet. Les propriétés qui ne sont pas spécifiées dans updateProperties ne sont pas modifiées.

Paramètres

tabId

number facultatif

La valeur par défaut est l'onglet sélectionné de la fenêtre actuelle.
updateProperties

objet
- actif
  
  boolean facultatif
  
  Indique si l'onglet doit être actif. N'affecte pas la sélection de la fenêtre (voir windows.update).
- autoDiscardable
  
  boolean facultatif
  
  Chrome 54 ou version ultérieure
  
  Indique si l'onglet doit être automatiquement supprimé par le navigateur lorsque les ressources sont faibles.
- en surbrillance
  
  boolean facultatif
  
  Ajoute l'onglet à la sélection actuelle ou l'en supprime.
- son coupé
  
  boolean facultatif
  
  Chrome 45 ou version ultérieure
  
  Indique si l'onglet doit être coupé.
- openerTabId
  
  number facultatif
  
  ID de l'onglet qui a ouvert cet onglet. Si cette propriété est spécifiée, l'onglet d'ouverture doit se trouver dans la même fenêtre que cet onglet.
- épinglé
  
  boolean facultatif
  
  Indique si l'onglet doit être épinglé.
- sélectionné
  
  boolean facultatif
  
  Obsolète
  
  Veuillez utiliser highlighted.
  Indique si l'onglet doit être sélectionné.
- url
  
  chaîne facultatif
  
  URL vers laquelle l'onglet doit naviguer. Les URL JavaScript ne sont pas acceptées. Utilisez plutôt scripting.executeScript.
callback

function facultatif

Le paramètre callback se présente comme suit :
```
(tab?: Tab) => void
```
- tabulation
  
  Tab facultatif
  
  Détails sur l'onglet mis à jour. Les propriétés url, pendingUrl, title et favIconUrl ne sont incluses dans l'objet tabs.Tab que si l'extension dispose de l'autorisation "tabs" ou d'autorisations d'hôte pour la page.

Renvoie

Promise<Tab | undefined>

Chrome 88 ou version ultérieure

Les promesses ne sont compatibles qu'avec Manifest V3 et les versions ultérieures. Les autres plates-formes doivent utiliser des rappels.

Événements

onActivated

chrome.tabs.onActivated.addListener(
  callback: function,
)

Se déclenche lorsque l'onglet actif d'une fenêtre change. Notez que l'URL de l'onglet n'est peut-être pas définie au moment où cet événement est déclenché, mais vous pouvez écouter les événements onUpdated pour être averti lorsqu'une URL est définie.

Paramètres

callback

fonction

Le paramètre callback se présente comme suit :
```
(activeInfo: object) => void
```
- activeInfo
  
  objet
  - tabId
    
    nombre
    
    ID de l'onglet qui est devenu actif.
  - windowId
    
    nombre
    
    ID de la fenêtre dans laquelle l'onglet actif a changé.

onActiveChanged

&leq; MV2 Obsolète

chrome.tabs.onActiveChanged.addListener(
  callback: function,
)

Veuillez utiliser tabs.onActivated.

Se déclenche lorsque l'onglet sélectionné dans une fenêtre change. Notez que l'URL de l'onglet n'est peut-être pas définie au moment où cet événement est déclenché, mais vous pouvez écouter les événements tabs.onUpdated pour être averti lorsqu'une URL est définie.

Paramètres

callback

fonction

Le paramètre callback se présente comme suit :
```
(tabId: number, selectInfo: object) => void
```
- tabId
  
  nombre
- selectInfo
  
  objet
  - windowId
    
    nombre
    
    ID de la fenêtre dans laquelle l'onglet sélectionné a été modifié.

onAttached

chrome.tabs.onAttached.addListener(
  callback: function,
)

Se déclenche lorsqu'un onglet est associé à une fenêtre, par exemple parce qu'il a été déplacé d'une fenêtre à une autre.

Paramètres

callback

fonction

Le paramètre callback se présente comme suit :
```
(tabId: number, attachInfo: object) => void
```
- tabId
  
  nombre
- attachInfo
  
  objet
  - newPosition
    
    nombre
  - newWindowId
    
    nombre

onCreated

chrome.tabs.onCreated.addListener(
  callback: function,
)

Déclenché lorsqu'un onglet est créé. Notez que l'URL de l'onglet et l'appartenance au groupe d'onglets peuvent ne pas être définies au moment où cet événement est déclenché, mais vous pouvez écouter les événements onUpdated pour être averti lorsqu'une URL est définie ou que l'onglet est ajouté à un groupe d'onglets.

Paramètres

callback

fonction

Le paramètre callback se présente comme suit :
```
(tab: Tab) => void
```
- tabulation
  
  Tabulation

onDetached

chrome.tabs.onDetached.addListener(
  callback: function,
)

Se déclenche lorsqu'un onglet est dissocié d'une fenêtre, par exemple parce qu'il a été déplacé entre des fenêtres.

Paramètres

callback

fonction

Le paramètre callback se présente comme suit :
```
(tabId: number, detachInfo: object) => void
```
- tabId
  
  nombre
- detachInfo
  
  objet
  - oldPosition
    
    nombre
  - oldWindowId
    
    nombre

onHighlightChanged

&leq; MV2 Obsolète

chrome.tabs.onHighlightChanged.addListener(
  callback: function,
)

Veuillez utiliser tabs.onHighlighted.

Se déclenche lorsque les onglets mis en surbrillance ou sélectionnés dans une fenêtre changent.

Paramètres

callback

fonction

Le paramètre callback se présente comme suit :
```
(selectInfo: object) => void
```
- selectInfo
  
  objet
  - tabIds
    
    number[]
    
    Tous les onglets mis en surbrillance dans la fenêtre.
  - windowId
    
    nombre
    
    Fenêtre dont les onglets ont été modifiés.

onHighlighted

chrome.tabs.onHighlighted.addListener(
  callback: function,
)

Se déclenche lorsque les onglets mis en surbrillance ou sélectionnés dans une fenêtre changent.

Paramètres

callback

fonction

Le paramètre callback se présente comme suit :
```
(highlightInfo: object) => void
```
- highlightInfo
  
  objet
  - tabIds
    
    number[]
    
    Tous les onglets mis en surbrillance dans la fenêtre.
  - windowId
    
    nombre
    
    Fenêtre dont les onglets ont été modifiés.

onMoved

chrome.tabs.onMoved.addListener(
  callback: function,
)

Se déclenche lorsqu'un onglet est déplacé dans une fenêtre. Un seul événement de déplacement est déclenché, représentant l'onglet que l'utilisateur a directement déplacé. Les événements de déplacement ne sont pas déclenchés pour les autres onglets qui doivent être déplacés en réponse à l'onglet déplacé manuellement. Cet événement n'est pas déclenché lorsqu'un onglet est déplacé d'une fenêtre à une autre. Pour en savoir plus, consultez tabs.onDetached.

Paramètres

callback

fonction

Le paramètre callback se présente comme suit :
```
(tabId: number, moveInfo: object) => void
```
- tabId
  
  nombre
- moveInfo
  
  objet
  - fromIndex
    
    nombre
  - toIndex
    
    nombre
  - windowId
    
    nombre

onRemoved

chrome.tabs.onRemoved.addListener(
  callback: function,
)

Déclenché lorsqu'un onglet est fermé.

Paramètres

callback

fonction

Le paramètre callback se présente comme suit :
```
(tabId: number, removeInfo: object) => void
```
- tabId
  
  nombre
- removeInfo
  
  objet
  - isWindowClosing
    
    booléen
    
    "True" lorsque l'onglet a été fermé, car sa fenêtre parente a été fermée.
  - windowId
    
    nombre
    
    Fenêtre dont l'onglet est fermé.

onReplaced

chrome.tabs.onReplaced.addListener(
  callback: function,
)

Se déclenche lorsqu'un onglet est remplacé par un autre en raison d'un prérendu ou d'un instantané.

Paramètres

callback

fonction

Le paramètre callback se présente comme suit :
```
(addedTabId: number, removedTabId: number) => void
```
- addedTabId
  
  nombre
- removedTabId
  
  nombre

onSelectionChanged

&leq; MV2 Obsolète

chrome.tabs.onSelectionChanged.addListener(
  callback: function,
)

Veuillez utiliser tabs.onActivated.

Se déclenche lorsque l'onglet sélectionné dans une fenêtre change.

Paramètres

callback

fonction

Le paramètre callback se présente comme suit :
```
(tabId: number, selectInfo: object) => void
```
- tabId
  
  nombre
- selectInfo
  
  objet
  - windowId
    
    nombre
    
    ID de la fenêtre dans laquelle l'onglet sélectionné a été modifié.

onUpdated

chrome.tabs.onUpdated.addListener(
  callback: function,
)

Déclenché lorsqu'un onglet est mis à jour.

Paramètres

callback

fonction

Le paramètre callback se présente comme suit :
```
(tabId: number, changeInfo: object, tab: Tab) => void
```
- tabId
  
  nombre
- changeInfo
  
  objet
  - audible
    
    boolean facultatif
    
    Chrome 45 ou version ultérieure
    
    Nouvel état sonore de l'onglet.
  - autoDiscardable
    
    boolean facultatif
    
    Chrome 54 ou version ultérieure
    
    Nouvel état d'abandon automatique de l'onglet.
  - avez supprimé
    
    boolean facultatif
    
    Chrome 54 ou version ultérieure
    
    Nouvel état d'abandon de l'onglet.
  - favIconUrl
    
    chaîne facultatif
    
    Nouvelle URL du favicon de l'onglet.
  - figé
    
    boolean facultatif
    
    Chrome 132 ou version ultérieure
    
    Nouvel état figé de l'onglet.
  - groupId
    
    number facultatif
    
    Chrome 88 ou version ultérieure
    
    Nouveau groupe de l'onglet.
  - mutedInfo
    
    MutedInfo facultatif
    
    Chrome 46 ou version ultérieure
    
    Le nouvel état de coupure du son de l'onglet et la raison de la modification.
  - épinglé
    
    boolean facultatif
    
    Nouvel état d'épinglage de l'onglet.
  - splitViewId
    
    number facultatif
    
    Chrome 140 ou version ultérieure
    
    La nouvelle vue fractionnée de l'onglet.
  - état
    
    TabStatus facultatif
    
    État de chargement de l'onglet.
  - titre
    
    chaîne facultatif
    
    Chrome 48 ou version ultérieure
    
    Nouveau titre de l'onglet.
  - url
    
    chaîne facultatif
    
    L'URL de l'onglet si elle a changé.
- tabulation
  
  Tabulation

onZoomChange

chrome.tabs.onZoomChange.addListener(
  callback: function,
)

Se déclenche lorsqu'un zoom est effectué sur un onglet.

Paramètres

callback

fonction

Le paramètre callback se présente comme suit :
```
(ZoomChangeInfo: object) => void
```
- ZoomChangeInfo
  
  objet
  - newZoomFactor
    
    nombre
  - oldZoomFactor
    
    nombre
  - tabId
    
    nombre
  - zoomSettings
    
    ZoomSettings

chrome.tabs Restez organisé à l'aide des collections Enregistrez et classez les contenus selon vos préférences.

Description

Présentation

Autorisations

Fichier manifeste

Cas d'utilisation

Ouverture d'une page d'extension dans un nouvel onglet

Obtenir l'onglet actuel

Couper le son de l'onglet spécifié

Déplacer l'onglet actuel vers la première position lorsque l'utilisateur clique dessus

Transmettre un message au script de contenu d'un onglet sélectionné

Exemples d'extensions

Types

MutedInfo

Propriétés

MutedInfoReason

Énumération

Tab

Propriétés

TabStatus

Énumération

WindowType

Énumération

ZoomSettings

Propriétés

ZoomSettingsMode

Énumération

ZoomSettingsScope

Énumération

Propriétés

MAX_CAPTURE_VISIBLE_TAB_CALLS_PER_SECOND

Valeur

SPLIT_VIEW_ID_NONE

Valeur

TAB_ID_NONE

Valeur

TAB_INDEX_NONE

Valeur

Méthodes

captureVisibleTab()

Paramètres

Renvoie

connect()

Paramètres

Renvoie

create()

Paramètres

Renvoie

createSplit()

Paramètres

Renvoie

detectLanguage()

Paramètres

Renvoie

discard()

Paramètres

Renvoie

duplicate()

Paramètres

Renvoie

executeScript()

Paramètres

Renvoie

get()

Paramètres

Renvoie

getAllInWindow()

Paramètres

Renvoie

getCurrent()

Paramètres

Renvoie

getSelected()

Paramètres

Renvoie

getZoom()

Paramètres

Renvoie

getZoomSettings()

Paramètres

chrome.tabs