chrome.tabs

Remarque:L'API Tabs peut être utilisée par les service workers et les pages d'extension, mais pas par les scripts de contenu.

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 des onglets dans le navigateur.

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

Autorisations

L'utilisation de la plupart des fonctionnalités ne nécessite aucune autorisation. Par exemple: créer un onglet, actualiser un onglet, accéder à une autre URL, etc.

Il existe trois autorisations dont les développeurs doivent être conscients lorsqu'ils utilisent l'API Tabs.

L'autorisation "tabs"

Cette autorisation ne donne pas accès à l'espace de noms chrome.tabs. En revanche, elle permet à une extension d'appeler tabs.query() sur quatre propriétés sensibles sur les instances tabs.Tab: url, pendingUrl, title et favIconUrl.

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

Autorisations d'hôte

Les autorisations d'hôte permettent à une extension de lire et d'interroger les quatre propriétés tabs.Tab sensibles d'un onglet correspondant. Elles peuvent également interagir directement avec les onglets correspondants à l'aide de méthodes telles que tabs.captureVisibleTab(), tabs.executeScript(), tabs.insertCSS() et tabs.removeCSS().

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

L'autorisation "activeTab"

activeTab accorde à une extension une autorisation d'hôte temporaire pour l'onglet actuel en réponse à un appel utilisateur. Contrairement aux autorisations d'hôte, activeTab ne déclenche aucun avertissement.

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

Cas d'utilisation

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

Ouvrir la page d'une extension dans un nouvel onglet

Un modèle courant pour les extensions consiste à ouvrir une page d'accueil 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"
    });
  }
});

Remarque:Cet exemple ne nécessite aucune autorisation.

Obtenir l'onglet actif

Cet exemple montre comment le service worker d'une extension peut récupérer l'onglet actif à partir de la fenêtre actuellement sélectionnée (ou de la dernière fenêtre sélectionnée, 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);
    });
  }

Ignorer l'onglet spécifié

Cet exemple montre comment une extension peut activer/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 actif en première position lorsque vous cliquez dessus

Cet exemple montre comment déplacer un onglet alors qu'un déplacement peut être en cours ou non. Bien que cet exemple utilise chrome.tabs.move, vous pouvez utiliser le même schéma d'attente pour les autres appels qui modifient les onglets pendant qu'un déplacement 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);
      }
    }
  }

Important:L'utilisation de catch(error) dans une promesse permet de s'assurer qu'une erreur qui autrement inséré dans "chrome.runtime.lastError" n'est pas décochée.

  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 voir d'autres démonstrations des extensions de l'API Tabs, consultez les ressources suivantes:

• Manifest V2 – Extensions de l'API Tabs
• Manifest V3 - Gestionnaire d'onglets.

Types

MutedInfo

Chrome 46 ou version ultérieure

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

Propriétés

• extensionId

  string facultatif

  ID de l'extension qui a modifié l'état du son. Non défini si une extension n'est pas à l'origine du dernier changement d'état du son.

• son coupé

  boolean

  Indique si le son de l'onglet est coupé (il est impossible d'émettre des sons). Il est possible que le son de l'onglet soit coupé même s'il n'a pas été lu ou s'il n'en diffuse aucun son en cours. Équivaut à l'affichage de l'indicateur de son "son coupé".

• reason

  MutedInfoReason facultatif

  Raison pour laquelle le son de l'onglet a été coupé ou réactivé. Non défini si le 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 du son.

Enum

"user"
Une action d'entrée utilisateur définit le son.

"capture"
La capture d'onglet a démarré, forçant le changement d'état du son.

"extension"
Une extension, identifiée par le champ extensionId, définit l'état de son coupé.

Tab

Propriétés

• actif

  boolean

  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

  Booléen facultatif

  Chrome 45 ou version ultérieure

  Indique si l'onglet a produit un son au cours des deux dernières secondes (mais il risque de ne pas être entendu s'il a également coupé le son). Équivaut à l'affichage de l'indicateur "audio de l'enceinte".

• autoDiscardable

  boolean

  Chrome 54 et versions ultérieures

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

• avez supprimé

  boolean

  Chrome 54 et versions ultérieures

  Indique si l'onglet est supprimé. Un onglet supprimé est un onglet dont le contenu a été déchargé de la mémoire, mais est toujours visible dans la barre d'onglets. Son contenu sera actualisé la prochaine fois qu'il sera activé.

• favIconUrl

  string facultatif

  URL du favicon de l'onglet. Cette propriété n'est présente que si le fichier manifeste de l'extension inclut l'autorisation "tabs". Il peut également s'agir d'une chaîne vide si l'onglet est en cours de chargement.

• groupId

  Nombre

  Chrome 88 et versions ultérieures

  ID du groupe auquel l'onglet appartient.

• taille

  numéro facultatif

  Hauteur de l'onglet en pixels.

• en surbrillance

  boolean

  Indique si l'onglet est mis en surbrillance.

• id

  numéro facultatif

  ID de l'onglet. Les ID d'onglet sont uniques dans une session de navigateur. Dans certains cas, aucun identifiant n'est attribué à un onglet, par exemple lorsque vous interrogez des onglets étrangers à l'aide de l'API sessions, auquel cas un ID de session peut être présent. L'ID de l'onglet peut également être défini sur chrome.tabs.TAB_ID_NONE pour les fenêtres d'applications et d'outils de développement.

• navigation privée

  boolean

  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

  numéro facultatif

  Chrome 121 et versions ultérieures

  Nombre de millisecondes écoulées depuis l'epoch du dernier accès à l'onglet.

• mutedInfo

  MutedInfo facultatif

  Chrome 46 ou version ultérieure

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

• openerTabId

  numéro facultatif

  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.

• pendingUrl

  string facultatif

  Chrome 79 et versions ultérieures

  URL vers laquelle l'onglet accède, avant qu'il ne soit validé. Cette propriété n'est présente que si le fichier manifeste de l'extension inclut l'autorisation "tabs" et qu'une navigation est en attente.

• épinglé

  boolean

  Si l'onglet est épinglé ou non

• sélectionné(s)

  boolean

  Obsolète

  Veuillez utiliser tabs.Tab.highlighted.

  Indique si l'onglet est sélectionné.

• sessionId

  string facultatif

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

• status

  TabStatus facultatif

  État de chargement de l'onglet.

• title

  string facultatif

  Titre de l'onglet. Cette propriété n'est présente que si le fichier manifeste de l'extension inclut l'autorisation "tabs".

• url

  string facultatif

  Dernière URL validée du frame principal de l'onglet. Cette propriété n'est présente que si le fichier manifeste de l'extension inclut l'autorisation "tabs". Elle peut être une chaîne vide si l'onglet n'a pas encore été validé. Voir aussi Tab.pendingUrl.

• largeur

  numéro facultatif

  Largeur de l'onglet en pixels.

• windowId

  Nombre

  ID de la fenêtre qui contient l'onglet.

TabStatus

Chrome 44 ou version ultérieure

État de chargement de l'onglet.

Enum

"complete"

WindowType

Chrome 44 ou version ultérieure

Type de fenêtre.

Enum

"normal"

"panel"

"devtools"

ZoomSettings

Définit la manière dont les changements de zoom dans un onglet sont traités et à quel niveau.

Propriétés

• defaultZoomFactor

  numéro facultatif

  Chrome 43 et versions ultérieures

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

• Standard

  ZoomSettingsMode facultatif

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

• champ d'application

  ZoomSettingsScope facultatif

  Définit si les changements de zoom sont conservés pour l'origine de la page ou s'ils ne s'appliquent que dans 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 de zoom sont gérées, c'est-à-dire l'entité responsable de la mise à l'échelle réelle de la page. Valeur par défaut : automatic.

Enum

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

"manual"
Ignore la gestion automatique des modifications du zoom. L'événement onZoomChange sera toujours envoyé, et il incombe à l'extension d'écouter cet événement et d'ajuster 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.

"désactivé"
Désactive tout zoom sur l'onglet. Le niveau de zoom par défaut est rétabli et toutes les tentatives de modification du zoom sont ignorées.

ZoomSettingsScope

Chrome 44 ou version ultérieure

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

Enum

"per-origin"
Les modifications de zoom sont conservées sur l'origine de la page agrandie, c'est-à-dire que le zoom s'applique également à tous les autres onglets consultés vers cette même origine. De plus, les modifications de zoom per-origin sont enregistrées avec l'origine. Cela signifie que lorsque vous naviguez vers d'autres pages avec la même origine, elles sont toutes zoomées sur le même facteur de zoom. Le champ d'application per-origin n'est disponible qu'en mode automatic.

"par onglet"
Les modifications de zoom ne s'appliquent que dans cet onglet. Les changements de zoom dans les autres onglets n'affectent pas le zoom de cet onglet. De plus, les changements de zoom per-tab sont réinitialisés lors de la navigation. Lorsque vous naviguez dans un onglet, les pages sont toujours chargées avec leurs facteurs de zoom per-origin.

Propriétés

MAX_CAPTURE_VISIBLE_TAB_CALLS_PER_SECOND

Chrome 92 et versions ultérieures

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

Valeur

2

TAB_ID_NONE

Chrome 46 ou version ultérieure

ID représentant l'absence d'onglet du navigateur.

Valeur

-1

TAB_INDEX_NONE

Chrome 123 et versions ultérieures

Index représentant l'absence d'index de tabulation dans une barre de lecture tab_strip.

Valeur

-1

Méthodes

captureVisibleTab()

Promesse

chrome.tabs.captureVisibleTab(
  windowId?: number,
  options?: ImageDetails,
  callback?: function,
)

Capture la zone visible de l'onglet 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 ont normalement accès, cette méthode permet aux extensions de capturer les sites sensibles qui font l'objet de restrictions, y compris les pages chrome:-scheme, 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 fichier ne peuvent être capturées que si l'extension a été autorisée à accéder aux fichiers.

Paramètres

• windowId

  numéro facultatif

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

• options

  ImageDetails facultatif

• rappel

  fonction facultative

  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

• Promesse<chaîne>

  Chrome 88 et versions ultérieures

  Les promesses sont compatibles avec Manifest V3 et les versions ultérieures, mais des rappels sont fournis pour assurer la rétrocompatibilité. Vous ne pouvez pas utiliser les deux dans le même appel de fonction. La promesse est résolue avec le même type que celui transmis au rappel.

connect()

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

Se connecte au(s) script(s) de contenu dans 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 Messages du script de contenu.

Paramètres

• tabId

  Nombre

• connectInfo

  objet facultatif

  • documentId

    string facultatif

    Chrome 106 et versions ultérieures

    Ouvrez un port sur un document spécifique identifié par documentId au lieu de tous les cadres de l'onglet.

  • frameId

    numéro facultatif

    Ouvrez un port sur un frame spécifique identifié par frameId au lieu de tous les frames de l'onglet.

  • name

    string facultatif

    est transmise à onConnect pour les scripts de contenu qui écoutent l'événement de connexion.

Renvoie

• runtime.Port

  Port qui peut ê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()

Promesse

chrome.tabs.create(
  createProperties: object,
  callback?: function,
)

Crée un onglet.

Paramètres

• createProperties

  objet

  • actif

    Booléen facultatif

    Indique si l'onglet doit devenir l'onglet actif dans la fenêtre. Cela n'affecte pas la fenêtre active (voir windows.update). La valeur par défaut est true.

  • index

    numéro facultatif

    Position de l'onglet dans la fenêtre. La valeur fournie est comprise entre zéro et le nombre d'onglets dans la fenêtre.

  • openerTabId

    numéro 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 le nouvel onglet.

  • épinglé

    Booléen facultatif

    Épinglez ou non l'onglet. La valeur par défaut est false.

  • sélectionné(s)

    Booléen facultatif

    Obsolète

    Veuillez utiliser active.

    Définit si l'onglet doit devenir l'onglet sélectionné dans la fenêtre. La valeur par défaut est true.

  • url

    string facultatif

    URL vers laquelle accéder initialement à l'onglet. Les URL complètes doivent inclure un schéma (par exemple, "http://www.google.com", et non "www.google.com"). Les URL relatives se rapportent à la page active dans l'extension. La page "Nouvel onglet" est utilisée par défaut.

  • windowId

    numéro facultatif

    Fenêtre dans laquelle créer le nouvel onglet. La valeur par défaut est la fenêtre actuelle.

• rappel

  fonction facultative

  Le paramètre callback se présente comme suit :

  (tab: Tab)=>void

  • tab

    Tabulation

    Onglet créé.

Renvoie

• Promise<Tab>

  Chrome 88 et versions ultérieures

  Les promesses sont compatibles avec Manifest V3 et les versions ultérieures, mais des rappels sont fournis pour assurer la rétrocompatibilité. Vous ne pouvez pas utiliser les deux dans le même appel de fonction. La promesse est résolue avec le même type que celui transmis au rappel.

detectLanguage()

Promesse

chrome.tabs.detectLanguage(
  tabId?: number,
  callback?: function,
)

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

Paramètres

• tabId

  numéro facultatif

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

• rappel

  fonction facultative

  Le paramètre callback se présente comme suit :

  (language: string)=>void

  • language

    chaîne

    Un 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 deuxième à la quatrième colonnes sont vérifiées et la première valeur non nulle est renvoyée, à l'exception du chinois simplifié pour lequel zh-CN est renvoyé. Pour une langue inconnue/non définie, und est renvoyé.

Renvoie

• Promesse<chaîne>

  Chrome 88 et versions ultérieures

  Les promesses sont compatibles avec Manifest V3 et les versions ultérieures, mais des rappels sont fournis pour assurer la rétrocompatibilité. Vous ne pouvez pas utiliser les deux dans le même appel de fonction. La promesse est résolue avec le même type que celui transmis au rappel.

discard()

Promesse Chrome 54 et versions ultérieures

chrome.tabs.discard(
  tabId?: number,
  callback?: function,
)

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

Paramètres

• tabId

  numéro facultatif

  ID de l'onglet à supprimer. S'il est spécifié, il est supprimé, sauf s'il est actif ou déjà supprimé. En cas d'omission, le navigateur supprime l'onglet le moins important. Cette opération peut échouer s'il n'existe aucun onglet pouvant être supprimé.

• rappel

  fonction facultative

  Le paramètre callback se présente comme suit :

  (tab?: Tab)=>void

  • tab

    Tabulation facultatif

    Onglet supprimé, s'il a bien été supprimé, ou non défini dans le cas contraire.

Renvoie

• Promise<Tab|undefined>

  Chrome 88 et versions ultérieures

  Les promesses sont compatibles avec Manifest V3 et les versions ultérieures, mais des rappels sont fournis pour assurer la rétrocompatibilité. Vous ne pouvez pas utiliser les deux dans le même appel de fonction. La promesse est résolue avec le même type que celui transmis au rappel.

duplicate()

Promesse

chrome.tabs.duplicate(
  tabId: number,
  callback?: function,
)

Duplique un onglet.

Paramètres

• tabId

  Nombre

  ID de l'onglet à dupliquer.

• rappel

  fonction facultative

  Le paramètre callback se présente comme suit :

  (tab?: Tab)=>void

  • tab

    Tabulation facultatif

    Informations sur l'onglet dupliqué. L'objet tabs.Tab ne contient pas url, pendingUrl, title ni favIconUrl si l'autorisation "tabs" n'a pas été demandée.

Renvoie

• Promise<Tab|undefined>

  Chrome 88 et versions ultérieures

  Les promesses sont compatibles avec Manifest V3 et les versions ultérieures, mais des rappels sont fournis pour assurer la rétrocompatibilité. Vous ne pouvez pas utiliser les deux dans le même appel de fonction. La promesse est résolue avec le même type que celui transmis au rappel.

executeScript()

Promesse &leq; MV2 Obsolète depuis Chrome 91

chrome.tabs.executeScript(
  tabId?: number,
  details: InjectDetails,
  callback?: function,
)

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

  numéro facultatif

  ID de l'onglet dans lequel exécuter le script. La valeur par défaut est l'onglet actif de la fenêtre actuelle.

• détails

  InjectDetails

  Détails du script à exécuter. Le code ou la propriété de fichier doivent être définis, mais ils ne peuvent pas être définis en même temps.

• rappel

  fonction facultative

  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

• Promettre<toute[]|non défini>

  Chrome 88 et versions ultérieures

  Les promesses sont compatibles avec Manifest V3 et les versions ultérieures, mais des rappels sont fournis pour assurer la rétrocompatibilité. Vous ne pouvez pas utiliser les deux dans le même appel de fonction. La promesse est résolue avec le même type que celui transmis au rappel.

get()

Promesse

chrome.tabs.get(
  tabId: number,
  callback?: function,
)

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

Paramètres

• tabId

  Nombre

• rappel

  fonction facultative

  Le paramètre callback se présente comme suit :

  (tab: Tab)=>void

  • tab

    Tabulation

Renvoie

• Promise<Tab>

  Chrome 88 et versions ultérieures

  Les promesses sont compatibles avec Manifest V3 et les versions ultérieures, mais des rappels sont fournis pour assurer la rétrocompatibilité. Vous ne pouvez pas utiliser les deux dans le même appel de fonction. La promesse est résolue avec le même type que celui transmis au rappel.

getAllInWindow()

Promesse &leq; MV2 Obsolète

chrome.tabs.getAllInWindow(
  windowId?: number,
  callback?: function,
)

Veuillez utiliser tabs.query {windowId: windowId}.

Récupère les détails de tous les onglets de la fenêtre spécifiée.

Paramètres

• windowId

  numéro facultatif

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

• rappel

  fonction facultative

  Le paramètre callback se présente comme suit :

  (tabs: Tab[])=>void

  • onglets

    Tabulation[]

Renvoie

• Promise<Tab[]>

  Chrome 88 et versions ultérieures

  Les promesses sont compatibles avec Manifest V3 et les versions ultérieures, mais des rappels sont fournis pour assurer la rétrocompatibilité. Vous ne pouvez pas utiliser les deux dans le même appel de fonction. La promesse est résolue avec le même type que celui transmis au rappel.

getCurrent()

Promesse

chrome.tabs.getCurrent(
  callback?: function,
)

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

Paramètres

• rappel

  fonction facultative

  Le paramètre callback se présente comme suit :

  (tab?: Tab)=>void

  • tab

    Tabulation facultatif

Renvoie

• Promise<Tab|undefined>

  Chrome 88 et versions ultérieures

  Les promesses sont compatibles avec Manifest V3 et les versions ultérieures, mais des rappels sont fournis pour assurer la rétrocompatibilité. Vous ne pouvez pas utiliser les deux dans le même appel de fonction. La promesse est résolue avec le même type que celui transmis au rappel.

getSelected()

Promesse &leq; MV2 Obsolète

chrome.tabs.getSelected(
  windowId?: number,
  callback?: function,
)

Veuillez utiliser tabs.query {active: true}.

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

Paramètres

• windowId

  numéro facultatif

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

• rappel

  fonction facultative

  Le paramètre callback se présente comme suit :

  (tab: Tab)=>void

  • tab

    Tabulation

Renvoie

• Promise<Tab>

  Chrome 88 et versions ultérieures

  Les promesses sont compatibles avec Manifest V3 et les versions ultérieures, mais des rappels sont fournis pour assurer la rétrocompatibilité. Vous ne pouvez pas utiliser les deux dans le même appel de fonction. La promesse est résolue avec le même type que celui transmis au rappel.

getZoom()

Promesse

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

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

Paramètres

• tabId

  numéro facultatif

  ID de l'onglet à partir duquel obtenir le facteur de zoom actuel. La valeur par défaut est l'onglet actif de la fenêtre actuelle.

• rappel

  fonction facultative

  Le paramètre callback se présente comme suit :

  (zoomFactor: number)=>void

  • zoomFactor

    Nombre

    Facteur de zoom actuel de l'onglet.

Renvoie

• Promesse<number>

  Chrome 88 et versions ultérieures

  Les promesses sont compatibles avec Manifest V3 et les versions ultérieures, mais des rappels sont fournis pour assurer la rétrocompatibilité. Vous ne pouvez pas utiliser les deux dans le même appel de fonction. La promesse est résolue avec le même type que celui transmis au rappel.

getZoomSettings()

Promesse

chrome.tabs.getZoomSettings(
  tabId?: number,
  callback?: function,
)

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

Paramètres

• tabId

  numéro facultatif

  ID de l'onglet d'où proviennent les paramètres de zoom actuels. La valeur par défaut est l'onglet actif de la fenêtre actuelle.

• rappel

  fonction facultative

  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 et versions ultérieures

  Les promesses sont compatibles avec Manifest V3 et les versions ultérieures, mais des rappels sont fournis pour assurer la rétrocompatibilité. Vous ne pouvez pas utiliser les deux dans le même appel de fonction. La promesse est résolue avec le même type que celui transmis au rappel.

goBack()

Promesse Chrome 72 et versions ultérieures

chrome.tabs.goBack(
  tabId?: number,
  callback?: function,
)

Revenez à la page précédente, si vous en avez une.

Paramètres

• tabId

  numéro facultatif

  ID de l'onglet à utiliser pour revenir en arrière. La valeur par défaut est l'onglet sélectionné dans la fenêtre actuelle.

• rappel

  fonction facultative

  Le paramètre callback se présente comme suit :

  ()=>void

Renvoie

• Promise<void>

  Chrome 88 et versions ultérieures

  Les promesses sont compatibles avec Manifest V3 et les versions ultérieures, mais des rappels sont fournis pour assurer la rétrocompatibilité. Vous ne pouvez pas utiliser les deux dans le même appel de fonction. La promesse est résolue avec le même type que celui transmis au rappel.

goForward()

Promesse Chrome 72 et versions ultérieures

chrome.tabs.goForward(
  tabId?: number,
  callback?: function,
)

Passez à la page suivante, si elle est disponible.

Paramètres

• tabId

  numéro facultatif

  ID de l'onglet à parcourir. Par défaut, il est défini sur l'onglet sélectionné dans la fenêtre actuelle.

• rappel

  fonction facultative

  Le paramètre callback se présente comme suit :

  ()=>void

Renvoie

• Promise<void>

  Chrome 88 et versions ultérieures

  Les promesses sont compatibles avec Manifest V3 et les versions ultérieures, mais des rappels sont fournis pour assurer la rétrocompatibilité. Vous ne pouvez pas utiliser les deux dans le même appel de fonction. La promesse est résolue avec le même type que celui transmis au rappel.

group()

Promesse Chrome 88 et versions ultérieures

chrome.tabs.group(
  options: object,
  callback?: function,
)

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. Utilisation impossible si groupId est déjà spécifié.

    • windowId

      numéro facultatif

      Fenêtre du nouveau groupe. Par défaut, la fenêtre actuelle est utilisée.

  • groupId

    numéro facultatif

    ID du groupe auquel ajouter les onglets. Si vous n'indiquez aucune valeur, un groupe sera créé.

  • tabIds

    numéro|[nombre,...nombre[]]

    ID de l'onglet ou liste des ID d'onglets à ajouter au groupe spécifié.

• rappel

  fonction facultative

  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

• Promesse<number>

  Les promesses sont compatibles avec Manifest V3 et les versions ultérieures, mais des rappels sont fournis pour assurer la rétrocompatibilité. Vous ne pouvez pas utiliser les deux dans le même appel de fonction. La promesse est résolue avec le même type que celui transmis au rappel.

highlight()

Promesse

chrome.tabs.highlight(
  highlightInfo: object,
  callback?: function,
)

Met en surbrillance les onglets donnés et sélectionne le premier d'un groupe. N'a aucun effet si l'onglet spécifié est actif.

Paramètres

• highlightInfo

  objet

  • onglets

    nombre|nombre[]

    Un ou plusieurs index de tabulation à mettre en évidence.

  • windowId

    numéro facultatif

    Fenêtre contenant les onglets

• rappel

  fonction facultative

  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

• Promettre<windows.Window>

  Chrome 88 et versions ultérieures

  Les promesses sont compatibles avec Manifest V3 et les versions ultérieures, mais des rappels sont fournis pour assurer la rétrocompatibilité. Vous ne pouvez pas utiliser les deux dans le même appel de fonction. La promesse est résolue avec le même type que celui transmis au rappel.

insertCSS()

Promesse &leq; MV2 Obsolète depuis Chrome 91

chrome.tabs.insertCSS(
  tabId?: number,
  details: InjectDetails,
  callback?: function,
)

Remplacé par scripting.insertCSS dans Manifest V3.

Il injecte du code CSS dans 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

  numéro facultatif

  ID de l'onglet dans lequel insérer le code 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. Le code ou la propriété de fichier doivent être définis, mais ils ne peuvent pas être définis en même temps.

• rappel

  fonction facultative

  Le paramètre callback se présente comme suit :

  ()=>void

Renvoie

• Promise<void>

  Chrome 88 et versions ultérieures

  Les promesses sont compatibles avec Manifest V3 et les versions ultérieures, mais des rappels sont fournis pour assurer la rétrocompatibilité. Vous ne pouvez pas utiliser les deux dans le même appel de fonction. La promesse est résolue avec le même type que celui transmis au rappel.

move()

Promesse

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

Déplace un ou plusieurs onglets vers un nouvel emplacement de la fenêtre ou 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

  nombre|nombre[]

  ID de l'onglet ou liste des ID d'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

    numéro facultatif

    La valeur par défaut est la fenêtre dans laquelle se trouve l'onglet.

• rappel

  fonction facultative

  Le paramètre callback se présente comme suit :

  (tabs: Tab|Tab[])=>void

  • onglets

    Tabulation|Tabulation[]

    Détails sur les onglets déplacés.

Renvoie

• Promesse<Tabulation|Tabulation[]>

  Chrome 88 et versions ultérieures

  Les promesses sont compatibles avec Manifest V3 et les versions ultérieures, mais des rappels sont fournis pour assurer la rétrocompatibilité. Vous ne pouvez pas utiliser les deux dans le même appel de fonction. La promesse est résolue avec le même type que celui transmis au rappel.

query()

Promesse

chrome.tabs.query(
  queryInfo: object,
  callback?: function,
)

Récupère tous les onglets comportant 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

    Booléen facultatif

    si les onglets sont actifs dans leurs fenêtres ;

  • audible

    Booléen facultatif

    Chrome 45 ou version ultérieure

    Indique si les onglets sont audibles.

  • autoDiscardable

    Booléen facultatif

    Chrome 54 et versions ultérieures

    Indique si les onglets peuvent être supprimés automatiquement par le navigateur lorsque les ressources sont insuffisantes.

  • currentWindow

    Booléen facultatif

    Indique si les onglets se trouvent dans la fenêtre actuelle.

  • avez supprimé

    Booléen facultatif

    Chrome 54 et versions ultérieures

    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 est toujours visible dans la barre d'onglets. Son contenu sera actualisé la prochaine fois qu'il sera activé.

  • groupId

    numéro facultatif

    Chrome 88 et versions ultérieures

    ID du groupe dans lequel se trouvent les onglets ou tabGroups.TAB_GROUP_ID_NONE pour les onglets dissociés.

  • en surbrillance

    Booléen facultatif

    Si les onglets sont mis en surbrillance.

  • index

    numéro facultatif

    La position des onglets dans leurs fenêtres.

  • lastFocusedWindow

    Booléen facultatif

    Indique si les onglets se trouvent dans la dernière fenêtre sélectionnée.

  • son coupé

    Booléen facultatif

    Chrome 45 ou version ultérieure

    Indique si le son des onglets est désactivé.

  • épinglé

    Booléen facultatif

    Épinglez ou non les onglets.

  • status

    TabStatus facultatif

    État de chargement de l'onglet.

  • title

    string facultatif

    Faites correspondre les titres de page à un modèle. Cette propriété est ignorée si l'extension ne dispose pas de l'autorisation "tabs".

  • url

    string|string[] optional

    Faites correspondre les onglets avec un ou plusieurs formats d'URL. Les identifiants de fragment ne correspondent pas. Cette propriété est ignorée si l'extension ne dispose pas de l'autorisation "tabs".

  • windowId

    numéro facultatif

    ID de la fenêtre parent, ou windows.WINDOW_ID_CURRENT pour la fenêtre actuelle.

  • windowType

    WindowType : facultatif

    Type de fenêtre dans lequel se trouvent les onglets.

• rappel

  fonction facultative

  Le paramètre callback se présente comme suit :

  (result: Tab[])=>void

  • résultat

    Tabulation[]

Renvoie

• Promise<Tab[]>

  Chrome 88 et versions ultérieures

  Les promesses sont compatibles avec Manifest V3 et les versions ultérieures, mais des rappels sont fournis pour assurer la rétrocompatibilité. Vous ne pouvez pas utiliser les deux dans le même appel de fonction. La promesse est résolue avec le même type que celui transmis au rappel.

reload()

Promesse

chrome.tabs.reload(
  tabId?: number,
  reloadProperties?: object,
  callback?: function,
)

Actualisez un onglet.

Paramètres

• tabId

  numéro facultatif

  ID de l'onglet à actualiser. Valeur par défaut : l'onglet sélectionné de la fenêtre actuelle.

• reloadProperties

  objet facultatif

  • bypassCache

    Booléen facultatif

    Indique s'il faut contourner la mise en cache locale. La valeur par défaut est false.

• rappel

  fonction facultative

  Le paramètre callback se présente comme suit :

  ()=>void

Renvoie

• Promise<void>

  Chrome 88 et versions ultérieures

  Les promesses sont compatibles avec Manifest V3 et les versions ultérieures, mais des rappels sont fournis pour assurer la rétrocompatibilité. Vous ne pouvez pas utiliser les deux dans le même appel de fonction. La promesse est résolue avec le même type que celui transmis au rappel.

remove()

Promesse

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

Ferme un ou plusieurs onglets.

Paramètres

• tabIds

  nombre|nombre[]

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

• rappel

  fonction facultative

  Le paramètre callback se présente comme suit :

  ()=>void

Renvoie

• Promise<void>

  Chrome 88 et versions ultérieures

  Les promesses sont compatibles avec Manifest V3 et les versions ultérieures, mais des rappels sont fournis pour assurer la rétrocompatibilité. Vous ne pouvez pas utiliser les deux dans le même appel de fonction. La promesse est résolue avec le même type que celui transmis au rappel.

removeCSS()

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

chrome.tabs.removeCSS(
  tabId?: number,
  details: DeleteInjectionDetails,
  callback?: function,
)

Remplacé par scripting.removeCSS dans Manifest V3.

Supprime un élément du CSS d'une page précédemment injecté par un appel à scripting.insertCSS.

Paramètres

• tabId

  numéro facultatif

  ID de l'onglet à partir duquel supprimer le CSS (par défaut, l'onglet actif de la fenêtre actuelle).

• détails

  DeleteInjectionDetails

  Détails du texte CSS à supprimer. Le code ou la propriété de fichier doivent être définis, mais ils ne peuvent pas être définis en même temps.

• rappel

  fonction facultative

  Le paramètre callback se présente comme suit :

  ()=>void

Renvoie

• Promise<void>

  Chrome 88 et versions ultérieures

  Les promesses sont compatibles avec Manifest V3 et les versions ultérieures, mais des rappels sont fournis pour assurer la rétrocompatibilité. Vous ne pouvez pas utiliser les deux dans le même appel de fonction. La promesse est résolue avec le même type que celui transmis au rappel.

sendMessage()

Promesse

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

Envoie un message unique 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 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

  toutes

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

• options

  objet facultatif

  • documentId

    string facultatif

    Chrome 106 et versions ultérieures

    Envoyez un message vers un document spécifique identifié par documentId au lieu de tous les cadres de l'onglet.

  • frameId

    numéro facultatif

    Envoyez un message à un cadre spécifique identifié par frameId, plutôt qu'à tous les cadres de l'onglet.

• rappel

  fonction facultative

  Chrome 99 et versions ultérieures

  Le paramètre callback se présente comme suit :

  (response: any)=>void

  • réponse

    toutes

    Objet de réponse JSON envoyé par le gestionnaire du message. Si une erreur se produit lors de la connexion à l'onglet spécifié, le rappel est appelé sans argument et runtime.lastError est défini sur le message d'erreur.

Renvoie

• Promettre<tout>

  Chrome 99 et versions ultérieures

  Les promesses sont compatibles avec Manifest V3 et les versions ultérieures, mais des rappels sont fournis pour assurer la rétrocompatibilité. Vous ne pouvez pas utiliser les deux dans le même appel de fonction. La promesse est résolue avec le même type que celui transmis au rappel.

sendRequest()

Promesse &leq; MV2 Obsolète

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

Veuillez utiliser runtime.sendMessage.

Envoie une requête unique 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

  toutes

• rappel

  fonction facultative

  Chrome 99 et versions ultérieures

  Le paramètre callback se présente comme suit :

  (response: any)=>void

  • réponse

    toutes

    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é, le rappel est appelé sans argument et runtime.lastError est défini sur le message d'erreur.

Renvoie

• Promettre<tout>

  Chrome 99 et versions ultérieures

  Les promesses sont compatibles avec Manifest V3 et les versions ultérieures, mais des rappels sont fournis pour assurer la rétrocompatibilité. Vous ne pouvez pas utiliser les deux dans le même appel de fonction. La promesse est résolue avec le même type que celui transmis au rappel.

setZoom()

Promesse

chrome.tabs.setZoom(
  tabId?: number,
  zoomFactor: number,
  callback?: function,
)

Permet de zoomer sur un onglet spécifié.

Paramètres

• tabId

  numéro facultatif

  ID de l'onglet sur lequel zoomer. La valeur par défaut est 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 (peut-être différent de celui par défaut) pour l'onglet.

• rappel

  fonction facultative

  Le paramètre callback se présente comme suit :

  ()=>void

Renvoie

• Promise<void>

  Chrome 88 et versions ultérieures

  Les promesses sont compatibles avec Manifest V3 et les versions ultérieures, mais des rappels sont fournis pour assurer la rétrocompatibilité. Vous ne pouvez pas utiliser les deux dans le même appel de fonction. La promesse est résolue avec le même type que celui transmis au rappel.

setZoomSettings()

Promesse

chrome.tabs.setZoomSettings(
  tabId?: number,
  zoomSettings: ZoomSettings,
  callback?: function,
)

Définit les paramètres de zoom d'un onglet spécifié, qui définissent la manière dont les modifications de zoom sont traitées. Les valeurs par défaut de ces paramètres sont rétablies lorsque vous naviguez dans l'onglet.

Paramètres

• tabId

  numéro facultatif

  ID de l'onglet pour lequel modifier les paramètres de zoom. La valeur par défaut est l'onglet actif de la fenêtre actuelle.

• zoomSettings

  ZoomSettings

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

• rappel

  fonction facultative

  Le paramètre callback se présente comme suit :

  ()=>void

Renvoie

• Promise<void>

  Chrome 88 et versions ultérieures

  Les promesses sont compatibles avec Manifest V3 et les versions ultérieures, mais des rappels sont fournis pour assurer la rétrocompatibilité. Vous ne pouvez pas utiliser les deux dans le même appel de fonction. La promesse est résolue avec le même type que celui transmis au rappel.

ungroup()

Promesse Chrome 88 et versions ultérieures

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

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

Paramètres

• tabIds

  numéro|[nombre,...nombre[]]

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

• rappel

  fonction facultative

  Le paramètre callback se présente comme suit :

  ()=>void

Renvoie

• Promise<void>

  Les promesses sont compatibles avec Manifest V3 et les versions ultérieures, mais des rappels sont fournis pour assurer la rétrocompatibilité. Vous ne pouvez pas utiliser les deux dans le même appel de fonction. La promesse est résolue avec le même type que celui transmis au rappel.

update()

Promesse

chrome.tabs.update(
  tabId?: number,
  updateProperties: object,
  callback?: function,
)

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

  numéro facultatif

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

• updateProperties

  objet

  • actif

    Booléen facultatif

    Indique si l'onglet doit être actif ou non. Cela n'a aucune incidence sur le fait que la fenêtre soit sélectionnée ou non (voir windows.update).

  • autoDiscardable

    Booléen facultatif

    Chrome 54 et versions ultérieures

    Indique si l'onglet doit être supprimé automatiquement par le navigateur lorsque les ressources sont insuffisantes.

  • en surbrillance

    Booléen facultatif

    Ajoute l'onglet à la sélection actuelle ou le supprime.

  • son coupé

    Booléen facultatif

    Chrome 45 ou version ultérieure

    Indique si le son de l'onglet doit être coupé.

  • openerTabId

    numéro 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 cet onglet.

  • épinglé

    Booléen facultatif

    Épinglez ou non l'onglet.

  • sélectionné(s)

    Booléen facultatif

    Obsolète

    Veuillez utiliser en surbrillance.

    Indique si l'onglet doit être sélectionné.

  • url

    string facultatif

    URL permettant d'accéder à l'onglet. Les URL JavaScript ne sont pas acceptées. Utilisez scripting.executeScript à la place.

• rappel

  fonction facultative

  Le paramètre callback se présente comme suit :

  (tab?: Tab)=>void

  • tab

    Tabulation facultatif

    Informations sur l'onglet mis à jour. L'objet tabs.Tab ne contient pas url, pendingUrl, title ni favIconUrl si l'autorisation "tabs" n'a pas été demandée.

Renvoie

• Promise<Tab|undefined>

  Chrome 88 et versions ultérieures

  Les promesses sont compatibles avec Manifest V3 et les versions ultérieures, mais des rappels sont fournis pour assurer la rétrocompatibilité. Vous ne pouvez pas utiliser les deux dans le même appel de fonction. La promesse est résolue avec le même type que celui transmis au rappel.

Événements

onActivated

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

Se déclenche lorsque l'onglet actif dans une fenêtre est modifié. Remarque : Il est possible que l'URL de l'onglet ne soit pas définie au moment du déclenchement de l'événement. Toutefois, vous pouvez écouter les événements onUpdated afin d'être averti lorsqu'une URL est définie.

Paramètres

• rappel

  function

  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 été modifié.

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 est modifié. Notez que l'URL de l'onglet peut ne pas être définie au moment du déclenchement de l'événement, mais vous pouvez écouter les événements tabs.onUpdated afin d'être averti lorsqu'une URL est définie.

Paramètres

• rappel

  function

  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,
)

Déclenché lorsqu'un onglet est associé à une fenêtre (par exemple, lorsqu'il a été déplacé d'une fenêtre à l'autre)

Paramètres

• rappel

  function

  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é lors de la création d'un onglet. Notez que l'URL de l'onglet et l'appartenance au groupe d'onglets peuvent ne pas être définies au moment du déclenchement de cet événement. Toutefois, vous pouvez écouter les événements onUpdated afin d'être averti lorsqu'une URL est définie ou lorsqu'un onglet est ajouté à un groupe d'onglets.

Paramètres

• rappel

  function

  Le paramètre callback se présente comme suit :

  (tab: Tab)=>void

  • tab

    Tabulation

onDetached

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

Déclenché lorsqu'un onglet est dissocié d'une fenêtre (lorsqu'il a été déplacé entre les fenêtres, par exemple)

Paramètres

• rappel

  function

  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.

Déclenché lorsque les onglets mis en surbrillance ou sélectionnés dans une fenêtre sont modifiés

Paramètres

• rappel

  function

  Le paramètre callback se présente comme suit :

  (selectInfo: object)=>void

  • selectInfo

    objet

    • tabIds

      nombre[]

      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,
)

Déclenché lorsque les onglets mis en surbrillance ou sélectionnés dans une fenêtre sont modifiés

Paramètres

• rappel

  function

  Le paramètre callback se présente comme suit :

  (highlightInfo: object)=>void

  • highlightInfo

    objet

    • tabIds

      nombre[]

      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,
)

Déclenché 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 devant être déplacés en réponse au déplacement manuel. Cet événement n'est pas déclenché lorsque vous déplacez un onglet d'une fenêtre à l'autre. Pour en savoir plus, consultez tabs.onDetached.

Paramètres

• rappel

  function

  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

• rappel

  function

  Le paramètre callback se présente comme suit :

  (tabId: number,removeInfo: object)=>void

  • tabId

    Nombre

  • removeInfo

    objet

    • isWindowClosing

      boolean

      Vrai lorsque l'onglet a été fermé, car sa fenêtre parente était fermée.

    • windowId

      Nombre

      La fenêtre dont l'onglet est fermé.

onReplaced

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

Déclenché lorsqu'un onglet est remplacé par un autre en raison du prérendu ou d'instantané.

Paramètres

• rappel

  function

  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 est modifié.

Paramètres

• rappel

  function

  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

• rappel

  function

  Le paramètre callback se présente comme suit :

  (tabId: number,changeInfo: object,tab: Tab)=>void

  • tabId

    Nombre

  • changeInfo

    objet

    • audible

      Booléen facultatif

      Chrome 45 ou version ultérieure

      Nouvel état audible de l'onglet.

    • autoDiscardable

      Booléen facultatif

      Chrome 54 et versions ultérieures

      Nouvel état de l'onglet pouvant être supprimé automatiquement.

    • avez supprimé

      Booléen facultatif

      Chrome 54 et versions ultérieures

      Nouvel état "Supprimé" de l'onglet.

    • favIconUrl

      string facultatif

      URL de la nouvelle favicon de l'onglet.

    • groupId

      numéro facultatif

      Chrome 88 et versions ultérieures

      Nouveau groupe de l'onglet.

    • mutedInfo

      MutedInfo facultatif

      Chrome 46 ou version ultérieure

      Nouvel état du son de l'onglet et motif de la modification.

    • épinglé

      Booléen facultatif

      Nouvel état épinglé de l'onglet.

    • status

      TabStatus facultatif

      État de chargement de l'onglet.

    • title

      string facultatif

      Chrome 48 ou version ultérieure

      Nouveau titre de l'onglet.

    • url

      string facultatif

      URL de l'onglet, si elle a été modifiée.

  • tab

    Tabulation

onZoomChange

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

Déclenché lors d'un zoom sur un onglet

Paramètres

• rappel

  function

  Le paramètre callback se présente comme suit :

  (ZoomChangeInfo: object)=>void

  • ZoomChangeInfo

    objet

    • newZoomFactor

      Nombre

    • oldZoomFactor

      Nombre

    • tabId

      Nombre

    • zoomSettings

      ZoomSettings