chrome.tabs

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.

L'API Tabs offre non seulement des fonctionnalités pour manipuler et gérer les onglets, mais elle peut également détecter les language [langue] de l'onglet, faites 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, actualisation d'un onglet, navigation vers une autre URL, etc.

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

Les onglets autorisation

Cette autorisation ne donne pas accès à l'espace de noms chrome.tabs. Au lieu de cela, il 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 données sensibles d'un onglet correspondant tabs.Tab. Ils peuvent également interagir directement avec les onglets correspondants à l'aide de méthodes telles que en tant que tabs.captureVisibleTab(), tabs.executeScript(), tabs.insertCSS() et tabs.removeCSS().

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

activeTab accorde à une extension une autorisation d'hôte temporaire pour l'onglet actuel dans à 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

Généralement, les extensions ouvrent une page d'accueil dans un nouvel onglet lorsque l'extension est installés. 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 à partir de fenêtre actuellement sélectionnée (ou la dernière fenêtre sélectionnée, si aucune fenêtre Chrome n'est sélectionnée). Ce peut généralement être considéré comme 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/désactiver le son pour 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 l'utilisateur clique dessus

Cet exemple montre comment déplacer un onglet alors qu'un déplacement est 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 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);
      }
    }
  }


  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 de l'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 plus de démonstrations des extensions de l'API Tabs, consultez l'un des documents suivants:

Types

MutedInfo

Chrome (version 46 ou ultérieure)

État de son coupé et motif du dernier changement d'état

Propriétés

  • extensionId

    chaîne facultatif

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

  • son coupé

    booléen

    Indique si le son de l'onglet est coupé (empêcher la lecture de son). Le son de l'onglet peut être coupé même s'il n'est pas lu ou s'il n'est pas en train de lire du son. Équivaut au fait que l'option "mute" l'indicateur audio s'affiche.

  • reason

    MutedInfoReason facultatif

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

MutedInfoReason

Chrome (version 46 ou ultérieure)

Événement ayant entraîné le changement d'état du son.

Énumération

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

"capture"
La capture d'onglet a démarré, ce qui a forcé le changement d'état du son.

"extension"
Une extension, identifiée par le champ extensionId, définit l'état 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 active.

  • audible

    Booléen facultatif

    Chrome 45 ou version ultérieure

    Indique si l'onglet a produit du son au cours des dernières secondes (mais il est possible qu'il ne soit pas audible s'il est également coupé). Équivaut au paramètre "audio du haut-parleur" s'affiche.

  • autoDiscardable

    booléen

    Chrome (version 54 ou ultérieure)

    Indique si le navigateur peut supprimer automatiquement l'onglet lorsque les ressources sont faibles.

  • avez supprimé

    booléen

    Chrome (version 54 ou 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 sera actualisé la prochaine fois qu'il sera activé.

  • favIconUrl

    chaîne 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 (version 88 ou ultérieure)

    ID du groupe auquel appartient l'onglet.

  • hauteur

    numéro facultatif

    Hauteur de l'onglet en pixels.

  • en surbrillance

    booléen

    Indique si l'onglet est en surbrillance.

  • id

    numéro facultatif

    ID de l'onglet. Les identifiants d'onglet sont uniques au sein d'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 des applications et 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

    Dernier accès à l'onglet, exprimé en nombre de millisecondes écoulées depuis l'epoch.

  • mutedInfo

    MutedInfo facultatif

    Chrome (version 46 ou ultérieure)

    État de son coupé et motif du dernier changement d'état

  • openerTabId

    numéro facultatif

    ID de l'onglet qui l'a ouvert, 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 et versions ultérieures

    URL vers laquelle l'onglet accède, avant qu'elle ne soit validée. 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é

    booléen

    Indique si l'onglet est épinglé.

  • sélectionné

    booléen

    <ph type="x-smartling-placeholder"></ph> Obsolète

    Veuillez utiliser tabs.Tab.highlighted.

    Indique si l'onglet est sélectionné.

  • sessionId

    chaîne facultatif

    ID de session utilisé pour identifier de manière unique un onglet obtenu à partir de l'API sessions.

  • é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 le fichier manifeste de l'extension inclut l'autorisation "tabs".

  • url

    chaîne facultatif

    La 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". Il peut s'agir d'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 (version 44 ou ultérieure)

État de chargement de l'onglet.

Énumération

"unloading"

"chargement en cours"

"complete"

WindowType

Chrome (version 44 ou ultérieure)

Type de fenêtre.

Énumération

"normal"

"popup"

"panel"

"application"

"devtools"

ZoomSettings

Définit comment les changements de zoom dans un onglet sont gérés et à quel niveau.

Propriétés

  • defaultZoomFactor

    numéro facultatif

    Chrome 43 ou version ultérieure

    Utilisée pour rétablir le niveau de zoom par défaut de l'onglet actuel dans les appels à tab.getZoomSettings.

  • mode

    ZoomSettingsMode optional

    Définit comment les changements de zoom sont gérés, c'est-à-dire quelle entité est responsable de la mise à l'échelle réelle de la page. la valeur par défaut est 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 prennent effet que dans cet onglet. la valeur par défaut est per-origin en mode automatic, et per-tab dans le cas contraire.

ZoomSettingsMode

Chrome (version 44 ou ultérieure)

Définit comment les changements de zoom sont gérés, c'est-à-dire quelle entité est responsable de la mise à l'échelle réelle de la page. la valeur par défaut est automatic.

Énumération

"automatique"
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 quand même envoyé, et l'extension sera responsable de l'écoute de cet événement et du scaling manuel de la page. Ce mode n'est pas compatible avec le zoom per-origin, et ignore donc le paramètre de zoom scope et suppose que la valeur est per-tab.

"disable"
Désactive tous les zooms de l'onglet. L'onglet rétablit le niveau de zoom par défaut, et toutes les tentatives de modification de zoom sont ignorées.

ZoomSettingsScope

Chrome (version 44 ou ultérieure)

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

Énumération

"per-origin"
Les changements de zoom sont conservés à l'origine de la page sur laquelle vous avez effectué un zoom, c'est-à-dire que tous les autres onglets accessibles à la même origine sont également zoomés. De plus, les modifications de zoom per-origin sont enregistrées avec l'origine, ce qui signifie que lorsque vous naviguez vers d'autres pages avec la même origine, un zoom est effectué selon le même facteur de zoom. Le champ d'application per-origin n'est disponible qu'en mode automatic.

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

Propriétés

MAX_CAPTURE_VISIBLE_TAB_CALLS_PER_SECOND

Chrome 92 ou version ultérieure

Nombre maximal d'appels de captureVisibleTab par seconde. captureVisibleTab est coûteux et ne doit pas être appelé trop souvent.

Valeur

2

TAB_ID_NONE

Chrome (version 46 ou ultérieure)

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

Valeur

-1

TAB_INDEX_NONE

Chrome 123 et versions ultérieures

Index qui représente l'absence d'index de tabulation dans une tab_strip.

Valeur

-1

Méthodes

captureVisibleTab()

<ph type="x-smartling-placeholder"></ph> Promesse 
chrome.tabs.captureVisibleTab(
  windowId?: number,
  options?: ImageDetails,
  callback?: function,
)

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 &lt;all_urls&gt; 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 font l'objet de restrictions par ailleurs, comme les pages chrome:-scheme, d'autres extensions pages et données: URL. Ces sites sensibles ne peuvent être capturés qu'avec l'autorisation activeTab. Les URL des fichiers ne peuvent être capturées que si l'extension dispose d'un accès au fichier.

Paramètres

  • windowId

    numéro facultatif

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

  • options

    ImageDetails facultatif

  • rappel

    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é à l'attribut "src" d'un élément HTML img à afficher.

Renvoie

  • Promise&lt;string&gt;

    Chrome (version 88 ou ultérieure)

    Les promesses sont prises en charge dans Manifest V3 et versions ultérieures, mais les rappels sont fournis pour rétrocompatibilité. Vous ne pouvez pas utiliser les deux sur le même appel de fonction. La 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 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 Message Content Script.

Paramètres

  • tabId

    Nombre

  • connectInfo

    objet facultatif

    • documentId

      chaîne facultatif

      Chrome 106 et versions ultérieures

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

    • frameId

      numéro facultatif

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

    • nom

      chaîne facultatif

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

Renvoie

  • Port permettant de 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()

<ph type="x-smartling-placeholder"></ph> 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. N'a pas d'incidence sur le fait que la fenêtre soit active ou non (voir windows.update). La valeur par défaut est true.

    • index

      numéro facultatif

      Position que l'onglet doit prendre 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 l'onglet que vous venez de créer.

    • épinglé

      Booléen facultatif

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

    • sélectionné

      Booléen facultatif

      <ph type="x-smartling-placeholder"></ph> 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.

    • url

      chaîne 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 sont relatives à la page actuelle de l'extension. La page "Nouvel onglet" est utilisée par défaut.

    • windowId

      numéro facultatif

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

  • rappel

    function facultatif

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

    (tab: Tab) => void

Renvoie

  • Promesse<Tabulation>

    Chrome (version 88 ou ultérieure)

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

detectLanguage()

<ph type="x-smartling-placeholder"></ph> Promesse 
chrome.tabs.detectLanguage(
  tabId?: number,
  callback?: function,
)

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

Paramètres

  • tabId

    numéro facultatif

    Par défaut, l'onglet actif de la fenêtre actuelle est sélectionné.

  • rappel

    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 acceptées par cette méthode, consultez la section kLanguageInfoTable. La deuxième à la quatrième colonne est vérifiée, 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

  • Promise&lt;string&gt;

    Chrome (version 88 ou ultérieure)

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

discard()

<ph type="x-smartling-placeholder"></ph> Promesse Chrome (version 54 ou ultérieure) 
chrome.tabs.discard(
  tabId?: number,
  callback?: function,
)

Supprime un onglet de la mémoire. Les onglets supprimés sont toujours 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. Si cet onglet est spécifié, il est supprimé, sauf s'il est actif ou déjà supprimé. S'il est omis, le navigateur supprime l'onglet le moins important. Cette opération peut échouer s'il n'existe aucun onglet pouvant être supprimé.

  • rappel

    function facultatif

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

    (tab?: Tab) => void

    • tabulation

      Tabulation facultatif

      L'onglet supprimé, s'il a bien été supprimé n'est pas défini dans le cas contraire.

Renvoie

  • Promesse <Tabulation | indéfini>

    Chrome (version 88 ou ultérieure)

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

duplicate()

<ph type="x-smartling-placeholder"></ph> Promesse 
chrome.tabs.duplicate(
  tabId: number,
  callback?: function,
)

Duplique un onglet.

Paramètres

  • tabId

    Nombre

    ID de l'onglet à dupliquer.

  • rappel

    function facultatif

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

    (tab?: Tab) => void

    • tabulation

      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

  • Promesse <Tabulation | indéfini>

    Chrome (version 88 ou ultérieure)

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

executeScript()

<ph type="x-smartling-placeholder"></ph> Promesse &amp;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. utilise par défaut l'onglet actif de la fenêtre actuelle.

  • détails

    InjectDetails

    Détails du script à exécuter. Vous devez définir soit le code, soit la propriété du fichier, mais vous ne pouvez pas les définir en même temps.

  • rappel

    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&lt;any[] | indéfini>

    Chrome (version 88 ou ultérieure)

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

get()

<ph type="x-smartling-placeholder"></ph> Promesse 
chrome.tabs.get(
  tabId: number,
  callback?: function,
)

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

Paramètres

  • tabId

    Nombre

  • rappel

    function facultatif

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

    (tab: Tab) => void

Renvoie

  • Promesse<Tabulation>

    Chrome (version 88 ou ultérieure)

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

getAllInWindow()

<ph type="x-smartling-placeholder"></ph> Promesse &amp;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

    function facultatif

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

    (tabs: Tab[]) => void

Renvoie

  • Promesse<Tabulation[]>

    Chrome (version 88 ou ultérieure)

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

getCurrent()

<ph type="x-smartling-placeholder"></ph> 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 qu'une tabulation (par exemple, une page en arrière-plan ou une vue pop-up).

Paramètres

  • rappel

    function facultatif

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

    (tab?: Tab) => void

Renvoie

  • Promesse <Tabulation | indéfini>

    Chrome (version 88 ou ultérieure)

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

getSelected()

<ph type="x-smartling-placeholder"></ph> Promesse &amp;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

    function facultatif

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

    (tab: Tab) => void

Renvoie

  • Promesse<Tabulation>

    Chrome (version 88 ou ultérieure)

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

getZoom()

<ph type="x-smartling-placeholder"></ph> 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

    Identifiant de l'onglet dans lequel obtenir le facteur de zoom actuel. utilise par défaut l'onglet actif de la fenêtre actuelle.

  • rappel

    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&lt;number&gt;

    Chrome (version 88 ou ultérieure)

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

getZoomSettings()

<ph type="x-smartling-placeholder"></ph> 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

    Identifiant de l'onglet dont vous souhaitez obtenir les paramètres de zoom actuels. utilise par défaut l'onglet actif de la fenêtre actuelle.

  • rappel

    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&lt;ZoomSettings&gt;

    Chrome (version 88 ou ultérieure)

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

goBack()

<ph type="x-smartling-placeholder"></ph> Promesse Chrome 72 ou version ultérieure 
chrome.tabs.goBack(
  tabId?: number,
  callback?: function,
)

Revenez à la page précédente, le cas échéant.

Paramètres

  • tabId

    numéro facultatif

    ID de l'onglet dans lequel revenir en arrière. utilise par défaut l'onglet sélectionné dans la fenêtre actuelle.

  • rappel

    function facultatif

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

    () => void

Renvoie

  • Promesse<void>

    Chrome (version 88 ou ultérieure)

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

goForward()

<ph type="x-smartling-placeholder"></ph> Promesse Chrome 72 ou version ultérieure 
chrome.tabs.goForward(
  tabId?: number,
  callback?: function,
)

Le cas échéant, passez à la page suivante.

Paramètres

  • tabId

    numéro facultatif

    ID de l'onglet dans lequel naviguer vers l'avant utilise par défaut l'onglet sélectionné dans la fenêtre actuelle.

  • rappel

    function facultatif

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

    () => void

Renvoie

  • Promesse<void>

    Chrome (version 88 ou ultérieure)

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

group()

<ph type="x-smartling-placeholder"></ph> Promesse Chrome (version 88 ou ultérieure) 
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 nouveau groupe.

Paramètres

  • options

    objet

    • createProperties

      objet facultatif

      Configurations permettant de créer un groupe. Utilisation impossible si l'élément groupId est déjà spécifié.

      • windowId

        numéro facultatif

        Fenêtre du nouveau groupe. La valeur par défaut est la fenêtre actuelle.

    • groupId

      numéro facultatif

      ID du groupe auquel ajouter les onglets. S'il n'est pas spécifié, un nouveau groupe sera créé.

    • tabIds

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

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

  • rappel

    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&lt;number&gt;

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

highlight()

<ph type="x-smartling-placeholder"></ph> Promesse 
chrome.tabs.highlight(
  highlightInfo: object,
  callback?: function,
)

Met en surbrillance les onglets donnés et se concentre sur le premier du groupe. N'a aucun effet si l'onglet spécifié est actif.

Paramètres

  • highlightInfo

    objet

    • onglets

      numéro | numéro[]

      Un ou plusieurs index de tabulation à mettre en surbrillance.

    • windowId

      numéro facultatif

      Fenêtre contenant les onglets.

  • rappel

    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&lt;windows.Window&gt;

    Chrome (version 88 ou ultérieure)

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

insertCSS()

<ph type="x-smartling-placeholder"></ph> Promesse &amp;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 CSS. utilise par défaut l'onglet actif de la fenêtre actuelle.

  • détails

    InjectDetails

    Détails du texte CSS à insérer. Vous devez définir soit le code, soit la propriété du fichier, mais vous ne pouvez pas les définir en même temps.

  • rappel

    function facultatif

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

    () => void

Renvoie

  • Promesse<void>

    Chrome (version 88 ou ultérieure)

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

move()

<ph type="x-smartling-placeholder"></ph> Promesse 
chrome.tabs.move(
  tabIds: number | number[],
  moveProperties: object,
  callback?: function,
)

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

    numéro | numéro[]

    ID d'onglet ou liste d'ID d'onglets à déplacer.

  • moveProperties

    objet

    • index

      Nombre

      Position vers laquelle la fenêtre doit être déplacée. Utilisez -1 pour placer l'onglet à la fin de la fenêtre.

    • windowId

      numéro facultatif

      Correspond par défaut à la fenêtre dans laquelle se trouve l'onglet.

  • rappel

    function facultatif

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

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

Renvoie

  • Promesse <Tabulation | Tabulation[]>

    Chrome (version 88 ou ultérieure)

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

query()

<ph type="x-smartling-placeholder"></ph> Promesse 
chrome.tabs.query(
  queryInfo: object,
  callback?: function,
)

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

      Indique si les onglets sont actifs dans leur fenêtre.

    • audible

      Booléen facultatif

      Chrome 45 ou version ultérieure

      Indique si les onglets sont audibles.

    • autoDiscardable

      Booléen facultatif

      Chrome (version 54 ou ultérieure)

      Indique si le navigateur peut supprimer automatiquement les onglets lorsque les ressources sont faibles.

    • currentWindow

      Booléen facultatif

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

    • avez supprimé

      Booléen facultatif

      Chrome (version 54 ou 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 sera actualisé la prochaine fois qu'il sera activé.

    • groupId

      numéro facultatif

      Chrome (version 88 ou ultérieure)

      ID du groupe contenant les onglets, ou tabGroups.TAB_GROUP_ID_NONE pour les onglets non groupés.

    • en surbrillance

      Booléen facultatif

      Indique si les onglets sont en surbrillance.

    • index

      numéro facultatif

      Position des onglets dans leur fenêtre.

    • 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

      Définit si le son des onglets est coupé.

    • épinglé

      Booléen facultatif

      Indique si les onglets sont épinglés.

    • état

      TabStatus facultatif

      État de chargement de l'onglet.

    • titre

      chaîne facultatif

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

    • url

      string | string[] facultatif

      Faites correspondre les onglets à 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 parente, ou windows.WINDOW_ID_CURRENT pour la fenêtre actuelle.

    • windowType

      WindowType facultatif

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

  • rappel

    function facultatif

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

    (result: Tab[]) => void

Renvoie

  • Promesse<Tabulation[]>

    Chrome (version 88 ou ultérieure)

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

reload()

<ph type="x-smartling-placeholder"></ph> Promesse 
chrome.tabs.reload(
  tabId?: number,
  reloadProperties?: object,
  callback?: function,
)

Actualisez un onglet.

Paramètres

  • tabId

    numéro facultatif

    ID de l'onglet à recharger. utilise par défaut l'onglet sélectionné dans la fenêtre actuelle.

  • reloadProperties

    objet facultatif

    • bypassCache

      Booléen facultatif

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

  • rappel

    function facultatif

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

    () => void

Renvoie

  • Promesse<void>

    Chrome (version 88 ou ultérieure)

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

remove()

<ph type="x-smartling-placeholder"></ph> Promesse 
chrome.tabs.remove(
  tabIds: number | number[],
  callback?: function,
)

Ferme un ou plusieurs onglets.

Paramètres

  • tabIds

    numéro | numéro[]

    ID des onglets ou liste des ID à fermer.

  • rappel

    function facultatif

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

    () => void

Renvoie

  • Promesse<void>

    Chrome (version 88 ou ultérieure)

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

removeCSS()

<ph type="x-smartling-placeholder"></ph> Promesse Chrome (version 87 ou ultérieure) &amp;leq; MV2 Obsolète depuis Chrome 91
chrome.tabs.removeCSS(
  tabId?: number,
  details: DeleteInjectionDetails,
  callback?: function,
)

Remplacé par scripting.removeCSS dans Manifest V3.

Supprime d'une page CSS qui a déjà été injectée par un appel à scripting.insertCSS.

Paramètres

  • tabId

    numéro facultatif

    ID de l'onglet dans lequel supprimer le CSS. utilise par défaut l'onglet actif de la fenêtre actuelle.

  • Détails du texte CSS à supprimer. Vous devez définir soit le code, soit la propriété du fichier, mais vous ne pouvez pas les définir en même temps.

  • rappel

    function facultatif

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

    () => void

Renvoie

  • Promesse<void>

    Chrome (version 88 ou ultérieure)

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

sendMessage()

<ph type="x-smartling-placeholder"></ph> Promesse 
chrome.tabs.sendMessage(
  tabId: number,
  message: any,
  options?: object,
  callback?: function,
)

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

    tous

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

  • options

    objet facultatif

    • documentId

      chaîne facultatif

      Chrome 106 et versions ultérieures

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

    • frameId

      numéro facultatif

      Envoyez un message à un frame spécifique identifié par frameId au lieu de tous les frames de l'onglet.

  • rappel

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

  • Promesse<tous>

    Chrome 99 ou version ultérieure

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

sendRequest()

<ph type="x-smartling-placeholder"></ph> Promesse &amp;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

    tous

  • rappel

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

Renvoie

  • Promesse<tous>

    Chrome 99 ou version ultérieure

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

setZoom()

<ph type="x-smartling-placeholder"></ph> Promesse 
chrome.tabs.setZoom(
  tabId?: number,
  zoomFactor: number,
  callback?: function,
)

Zoome sur un onglet spécifié.

Paramètres

  • tabId

    numéro facultatif

    Identifiant de l'onglet sur lequel effectuer un zoom. utilise par défaut 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

    function facultatif

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

    () => void

Renvoie

  • Promesse<void>

    Chrome (version 88 ou ultérieure)

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

setZoomSettings()

<ph type="x-smartling-placeholder"></ph> Promesse 
chrome.tabs.setZoomSettings(
  tabId?: number,
  zoomSettings: ZoomSettings,
  callback?: function,
)

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

Paramètres

  • tabId

    numéro facultatif

    Identifiant de l'onglet pour lequel modifier les paramètres de zoom. utilise par défaut l'onglet actif de la fenêtre actuelle.

  • zoomSettings

    ZoomSettings

    Définit comment les changements de zoom sont gérés et à quelle portée.

  • rappel

    function facultatif

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

    () => void

Renvoie

  • Promesse<void>

    Chrome (version 88 ou ultérieure)

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

ungroup()

<ph type="x-smartling-placeholder"></ph> Promesse Chrome (version 88 ou ultérieure) 
chrome.tabs.ungroup(
  tabIds: number | [number, ...number[]],
  callback?: function,
)

Supprime un ou plusieurs onglets de leurs groupes respectifs. Les groupes vides sont supprimés.

Paramètres

  • tabIds

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

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

  • rappel

    function facultatif

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

    () => void

Renvoie

  • Promesse<void>

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

update()

<ph type="x-smartling-placeholder"></ph> 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

    Par défaut, l'onglet sélectionné dans la fenêtre actuelle est sélectionné.

  • updateProperties

    objet

    • actif

      Booléen facultatif

      Indique si l'onglet doit être actif. N'a pas d'incidence sur le fait que la fenêtre soit active ou non (voir windows.update).

    • autoDiscardable

      Booléen facultatif

      Chrome (version 54 ou ultérieure)

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

    • 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

      Permet de désactiver ou non le son de l'onglet.

    • openerTabId

      numéro facultatif

      ID de l'onglet qui a ouvert cet onglet. Si cet onglet est spécifié, il doit se trouver dans la même fenêtre que cet onglet.

    • épinglé

      Booléen facultatif

      Épinglez ou non l'onglet.

    • sélectionné

      Booléen facultatif

      <ph type="x-smartling-placeholder"></ph> Obsolète

      Veuillez utiliser highlighted (en surbrillance).

      Permet de sélectionner ou non l'onglet.

    • url

      chaîne facultatif

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

  • rappel

    function facultatif

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

    (tab?: Tab) => void

    • tabulation

      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

  • Promesse <Tabulation | indéfini>

    Chrome (version 88 ou ultérieure)

    Les promesses sont prises en charge dans Manifest V3 et versions ultérieures, mais les rappels sont fournis pour rétrocompatibilité. Vous ne pouvez pas utiliser les deux sur le même appel de fonction. La 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é. Notez que l'URL de l'onglet n'est peut-être pas définie au moment du déclenchement de cet événement, mais vous pouvez écouter les événements onUpdated afin d'être averti lorsqu'une URL est définie.

Paramètres

  • rappel

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

onActiveChanged

<ph type="x-smartling-placeholder"></ph> &amp;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 n'est peut-être pas définie au moment du déclenchement de cet événement, mais vous pouvez écouter les événements tabs.onUpdated pour être averti lorsqu'une URL est définie.

Paramètres

  • rappel

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

Déclenché lorsqu'un onglet est associé à une fenêtre par exemple, parce qu'elle a été déplacée d'une fenêtre à l'autre.

Paramètres

  • rappel

    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 du déclenchement de cet événement, mais vous pouvez écouter les événements onUpdated afin d'être averti lorsqu'une URL est définie ou que l'onglet est ajouté à un groupe d'onglets.

Paramètres

  • rappel

    fonction

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

    (tab: Tab) => void

onDetached

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

Déclenché lorsqu'un onglet est détaché d'une fenêtre par exemple, parce qu'elle a été déplacée d'une fenêtre à l'autre.

Paramètres

  • rappel

    fonction

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

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

    • tabId

      Nombre

    • detachInfo

      objet

      • oldPosition

        Nombre

      • oldWindowId

        Nombre

onHighlightChanged

<ph type="x-smartling-placeholder"></ph> &amp;leq; MV2 Obsolète
chrome.tabs.onHighlightChanged.addListener(
  callback: function,
)

Veuillez utiliser tabs.onHighlighted.

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

Paramètres

  • rappel

    fonction

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

    (selectInfo: object) => void

    • selectInfo

      objet

      • tabIds

        numéro[]

        Tous les onglets mis en évidence 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 sélectionnés ou mis en surbrillance dans une fenêtre sont modifiés.

Paramètres

  • rappel

    fonction

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

    (highlightInfo: object) => void

    • highlightInfo

      objet

      • tabIds

        numéro[]

        Tous les onglets mis en évidence 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 déplacé directement. 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 à un 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

  • rappel

    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

  • rappel

    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é en raison de la fermeture de la fenêtre parente.

      • windowId

        Nombre

        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 de l'instantané.

Paramètres

  • rappel

    fonction

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

    (addedTabId: number, removedTabId: number) => void

    • addedTabId

      Nombre

    • removedTabId

      Nombre

onSelectionChanged

<ph type="x-smartling-placeholder"></ph> &amp;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

    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

  • rappel

    fonction

    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 (version 45 ou ultérieure)

        Nouvel état audible de l'onglet.

      • autoDiscardable

        Booléen facultatif

        Chrome (version 54 ou ultérieure)

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

      • avez supprimé

        Booléen facultatif

        Chrome (version 54 ou ultérieure)

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

      • favIconUrl

        chaîne facultatif

        Nouvelle URL du favicon de l'onglet

      • groupId

        numéro facultatif

        Chrome (version 88 ou ultérieure)

        Nouveau groupe de l'onglet.

      • mutedInfo

        MutedInfo facultatif

        Chrome (version 46 ou ultérieure)

        Nouvel état de son onglet "Son coupé" et motif de la modification.

      • épinglé

        Booléen facultatif

        Nouvel état épinglé de l'onglet.

      • état

        TabStatus facultatif

        État de chargement de l'onglet.

      • titre

        chaîne facultatif

        Chrome (version 48 ou ultérieure)

        Nouveau titre de l'onglet.

      • url

        chaîne facultatif

        L'URL de l'onglet s'il a changé

    • tabulation

      Tabulation

onZoomChange

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

Déclenché lorsqu'un utilisateur effectue un zoom sur un onglet.

Paramètres

  • rappel

    fonction

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

    (ZoomChangeInfo: object) => void

    • ZoomChangeInfo

      objet

      • newZoomFactor

        Nombre

      • oldZoomFactor

        Nombre

      • tabId

        Nombre

      • zoomSettings

        ZoomSettings