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, "/proxy/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