chrome.tabs

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

Description

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

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

Autorisations

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

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

Autorisation "Onglets"

Cette autorisation n'accorde pas d'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 de l'hôte

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

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

Autorisation "activeTab"

activeTab accorde à une extension une autorisation d'hôte temporaire pour l'onglet actuel en réponse à une invocation par l'utilisateur. Contrairement aux autorisations de l'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

Il est courant que les extensions ouvrent une page d'intégration dans un nouvel onglet lors de leur installation. L'exemple suivant montre comment procéder.

background.js:

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

Remarque:Cet exemple ne nécessite aucune autorisation.

Obtenir l'onglet actuel

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

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

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

Couper le son de l'onglet spécifié

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

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

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

Déplacer l'onglet actuel à la première position lorsqu'il est cliqué

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

  chrome.tabs.onActivated.addListener(moveToFirstPosition);

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

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

  chrome.tabs.onActivated.addListener(moveToFirstPositionMV2);

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

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

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

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

Exemples d'extensions

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

• Manifest V2 : extensions de l'API Tabs
• Manifest V3 – Gestionnaire d'onglets

Types

MutedInfo

Chrome 46 ou version ultérieure

État de la mise en sourdine de l'onglet et motif du dernier changement d'état.

Propriétés

• extensionId

  chaîne facultatif

  ID de l'extension ayant modifié l'état de mise en sourdine. Non défini si une extension n'est pas à l'origine du dernier changement de l'état de mise en sourdine.

• son coupé

  booléen

  Indique si le son de l'onglet est coupé. L'onglet peut être mis en sourdine même s'il n'a pas été lu ou s'il n'est pas en cours de lecture. Équivalent à l'affichage de l'indicateur audio "sourd".

• reason

  MutedInfoReason facultatif

  Raison pour laquelle l'onglet a été mis en sourdine ou rétabli. Non défini si l'état de désactivation de l'onglet n'a jamais été modifié.

MutedInfoReason

Chrome 46 ou version ultérieure

Événement ayant entraîné un changement d'état de mise en sourdine.

Énumération

"user"
Une action d'entrée utilisateur définit l'état de mise en sourdine.

"capture"
La capture d'onglet a été lancée, ce qui a forcé un changement d'état de mise en sourdine.

"extension"
Une extension, identifiée par le champ extensionId, définit l'état de mise en sourdine.

Tab

Propriétés

• actif

  booléen

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

• audible

  booléen facultatif

  Chrome 45 et versions ultérieures

  Indique si l'onglet a produit du son au cours des dernières secondes (mais il est possible que vous ne l'entendiez pas s'il est également mis en sourdine). Équivalent à l'affichage de l'indicateur "Audio de l'enceinte".

• autoDiscardable

  booléen

  Chrome 54 ou version ultérieure

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

• avez supprimé

  booléen

  Chrome 54 ou version ultérieure

  Indique si l'onglet est supprimé. Un onglet supprimé est un onglet dont le contenu a été supprimé de la mémoire, mais qui reste visible dans la barre d'onglets. Son contenu est réactualisé la prochaine fois qu'il est 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.

• figé

  booléen

  En attente

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

• groupId

  number

  Chrome 88 ou version ultérieure

  ID du groupe auquel appartient l'onglet.

• hauteur

  number facultatif

  Hauteur de l'onglet en pixels.

• en surbrillance

  booléen

  Indique si l'onglet est mis en surbrillance.

• id

  number facultatif

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

• navigation privée

  booléen

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

• index

  number

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

• lastAccessed

  number

  Chrome 121 ou version ultérieure

  Date et heure de la dernière utilisation de l'onglet, exprimées en millisecondes depuis l'epoch.

• mutedInfo

  MutedInfo facultatif

  Chrome 46 ou version ultérieure

  État de la mise en sourdine de l'onglet et motif du dernier changement d'état.

• openerTabId

  number facultatif

  ID de l'onglet qui a ouvert cet onglet, le cas échéant. Cette propriété n'est présente que si l'onglet d'ouverture existe toujours.

• pendingUrl

  chaîne facultatif

  Chrome 79 et versions ultérieures

  URL vers laquelle l'onglet accède avant d'être 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

  Obsolète

  Veuillez utiliser tabs.Tab.highlighted.

  Indique si l'onglet est sélectionné.

• sessionId

  chaîne facultatif

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

• é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

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

• largeur

  number facultatif

  Largeur de l'onglet en pixels.

• windowId

  number

  ID de la fenêtre contenant l'onglet.

TabStatus

Chrome 44 ou version ultérieure

État de chargement de l'onglet.

Énumération

"unloaded"

"loading"

"complete"

WindowType

Chrome 44 ou version ultérieure

Type de fenêtre.

Énumération

"normal"

"popup"

"panel"

"app"

"devtools"

ZoomSettings

Définit la manière dont les modifications de zoom dans un onglet sont gérées et à quelle étendue.

Propriétés

• defaultZoomFactor

  number facultatif

  Chrome 43 ou version ultérieure

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

• mode

  ZoomSettingsMode facultatif

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

• champ d'application

  ZoomSettingsScope facultatif

  Indique si les modifications de zoom persistent pour l'origine de la page ou ne s'appliquent qu'à cet onglet. La valeur par défaut est per-origin en mode automatic et per-tab dans le cas contraire.

ZoomSettingsMode

Chrome 44 ou version ultérieure

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

Énumération

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

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

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

ZoomSettingsScope

Chrome 44 ou version ultérieure

Indique si les modifications de zoom persistent pour l'origine de la page ou ne s'appliquent qu'à cet onglet. La valeur par défaut est per-origin en mode automatic et per-tab dans le cas contraire.

Énumération

"par origine"
Les modifications de zoom persistent dans l'origine de la page agrandie, c'est-à-dire que tous les autres onglets qui accèdent à cette même origine sont également agrandis. De plus, les modifications de zoom per-origin sont enregistrées avec l'origine. Par conséquent, lorsque vous accédez à d'autres pages de la même origine, elles sont toutes mises à l'échelle avec le même facteur de zoom. Le champ d'application per-origin n'est disponible que dans le mode automatic.

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

Propriétés

MAX_CAPTURE_VISIBLE_TAB_CALLS_PER_SECOND

Chrome 92 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 46 ou version ultérieure

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

Valeur

-1

TAB_INDEX_NONE

Chrome 123 ou version ultérieure

Index représentant l'absence d'un indice de tabulation dans une tab_strip.

Valeur

-1

Méthodes

captureVisibleTab()

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 <all_urls> ou de l'autorisation activeTab. En plus des sites auxquels les extensions peuvent normalement accéder, cette méthode permet aux extensions de capturer des sites sensibles qui sont autrement soumis à des restrictions, y compris les pages chrome:-scheme, les pages d'autres extensions et les URL data:. Ces sites sensibles ne peuvent être capturés qu'avec l'autorisation activeTab. Les URL de fichier ne peuvent être capturées que si l'extension a été autorisée à accéder aux fichiers.

Paramètres

• windowId

  number facultatif

  Fenêtre cible. Correspond par défaut à la fenêtre actuelle.

• options

  ImageDetails facultatif

• rappel

  fonction facultatif

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

  (dataUrl: string) => void

  • dataUrl

    chaîne

    URL de données qui encode une image de la zone visible de l'onglet capturé. Peut être attribué à la propriété "src" d'un élément HTML img pour l'affichage.

Renvoie

• Promise<string>

  Chrome 88 ou version ultérieure

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

connect()

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

Se connecte au ou 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 en cours. Pour en savoir plus, consultez Messagerie de script de contenu.

Paramètres

• tabId

  number

• connectInfo

  objet facultatif

  • documentId

    chaîne facultatif

    Chrome 106 ou version ultérieure

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

  • frameId

    number facultatif

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

  • nom

    chaîne facultatif

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

Renvoie

• runtime.Port

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

create()

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 la sélection de la fenêtre (voir windows.update). La valeur par défaut est true.

  • index

    number facultatif

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

  • openerTabId

    number facultatif

    ID de l'onglet qui a ouvert cet onglet. Si elle est spécifiée, l'onglet d'ouverture doit se trouver dans la même fenêtre que l'onglet nouvellement créé.

  • épinglé

    booléen facultatif

    Indique si l'onglet doit être épinglé. La valeur par défaut est false.

  • sélectionné

    booléen facultatif

    Obsolète

    Veuillez utiliser active.

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

  • url

    chaîne facultatif

    URL à laquelle accéder initialement dans l'onglet. Les URL complètes doivent inclure un schéma (c'est-à-dire "http://www.google.com", et non "www.google.com"). Les URL relatives sont relatives à la page actuelle de l'extension. Par défaut, la page "Nouvel onglet" s'affiche.

  • windowId

    number facultatif

    Fenêtre dans laquelle créer l'onglet. Correspond par défaut à la fenêtre actuelle.

• rappel

  fonction facultatif

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

  (tab: Tab) => void

  • tabulation

    Tabulation

    Onglet créé.

Renvoie

• Promise<Tab>

  Chrome 88 ou version ultérieure

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

detectLanguage()

Promesse

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

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

Paramètres

• tabId

  number facultatif

  Correspond par défaut à l'onglet actif de la fenêtre actuelle.

• rappel

  fonction facultatif

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

  (language: string) => void

  • language

    chaîne

    Code de langue ISO, tel que en ou fr. Pour obtenir la liste complète des langues compatibles avec cette méthode, consultez kLanguageInfoTable. Les deuxième à quatrième colonnes sont vérifiées, et la première valeur non NULL est renvoyée, sauf pour le chinois simplifié, pour lequel zh-CN est renvoyé. Pour une langue inconnue/non définie, und est renvoyé.

Renvoie

• Promise<string>

  Chrome 88 ou version ultérieure

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

discard()

Promise Chrome 54 et versions ultérieures

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

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

Paramètres

• tabId

  number facultatif

  ID de l'onglet à supprimer. Si elle est spécifiée, l'onglet est supprimé, sauf s'il est actif ou déjà supprimé. Si cet élément n'est pas spécifié, le navigateur supprime l'onglet le moins important. Cette opération peut échouer si aucun onglet ne peut être supprimé.

• rappel

  fonction facultatif

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

  (tab?: Tab) => void

  • tabulation

    Onglet facultatif

    L'onglet supprimé, s'il a bien été supprimé. Sinon, valeur non définie.

Renvoie

• Promise<Tab | undefined>

  Chrome 88 ou version ultérieure

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

duplicate()

Promesse

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

Duplique un onglet.

Paramètres

• tabId

  number

  ID de l'onglet à dupliquer.

• rappel

  fonction facultatif

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

  (tab?: Tab) => void

  • tabulation

    Onglet facultatif

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

Renvoie

• Promise<Tab | undefined>

  Chrome 88 ou version ultérieure

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

get()

Promesse

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

Récupère les informations sur l'onglet spécifié.

Paramètres

• tabId

  number

• rappel

  fonction facultatif

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

  (tab: Tab) => void

  • tabulation

    Tabulation

Renvoie

• Promise<Tab>

  Chrome 88 ou version ultérieure

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

getCurrent()

Promesse

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

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

Paramètres

• rappel

  fonction facultatif

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

  (tab?: Tab) => void

  • tabulation

    Onglet facultatif

Renvoie

• Promise<Tab | undefined>

  Chrome 88 ou version ultérieure

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

getZoom()

Promesse

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

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

Paramètres

• tabId

  number facultatif

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

• rappel

  fonction facultatif

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

  (zoomFactor: number) => void

  • zoomFactor

    number

    Facteur de zoom actuel de l'onglet.

Renvoie

• Promise<number>

  Chrome 88 ou version ultérieure

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

getZoomSettings()

Promesse

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

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

Paramètres

• tabId

  number facultatif

  ID de l'onglet à partir duquel obtenir les paramètres de zoom actuels. Par défaut, il s'agit de l'onglet actif de la fenêtre actuelle.

• rappel

  fonction facultatif

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

  (zoomSettings: ZoomSettings) => void

  • zoomSettings

    ZoomSettings

    Paramètres de zoom actuels de l'onglet.

Renvoie

• Promise<ZoomSettings>

  Chrome 88 ou version ultérieure

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

goBack()

Promise Chrome 72 et versions ultérieures

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

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

Paramètres

• tabId

  number facultatif

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

• rappel

  fonction facultatif

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

  () => void

Renvoie

• Promise<void>

  Chrome 88 ou version ultérieure

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

goForward()

Promise Chrome 72 et versions ultérieures

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

Passer à la page suivante, le cas échéant.

Paramètres

• tabId

  number facultatif

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

• rappel

  fonction facultatif

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

  () => void

Renvoie

• Promise<void>

  Chrome 88 ou version ultérieure

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

group()

Promise Chrome 88 et versions ultérieures

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

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

Paramètres

• options

  objet

  • createProperties

    objet facultatif

    Configurations pour créer un groupe. Ne peut pas être utilisé si groupId est déjà spécifié.

    • windowId

      number facultatif

      Fenêtre du nouveau groupe. Correspond par défaut à la fenêtre actuelle.

  • groupId

    number facultatif

    ID du groupe auquel ajouter les onglets. Si ce n'est pas le cas, un groupe est créé.

  • tabIds

    nombre | [nombre, ...nombre[]]

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

• rappel

  fonction facultatif

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

  (groupId: number) => void

  • groupId

    number

    ID du groupe auquel les onglets ont été ajoutés.

Renvoie

• Promise<number>

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

highlight()

Promesse

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

Met en surbrillance les onglets donnés et se concentre sur le premier du groupe. Aucune action ne sera effectuée si l'onglet spécifié est actuellement actif.

Paramètres

• highlightInfo

  objet

  • onglets

    nombre | nombre[]

    Un ou plusieurs indices d'onglets à mettre en surbrillance.

  • windowId

    number facultatif

    Fenêtre contenant les onglets.

• rappel

  fonction facultatif

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

  (window: Window) => void

  • fenêtre

    Fenêtre

    Contient des informations sur la fenêtre dont les onglets ont été mis en surbrillance.

Renvoie

• Promise<windows.Window>

  Chrome 88 ou version ultérieure

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

move()

Promesse

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

Déplace un ou plusieurs onglets vers une nouvelle position dans la 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

  nombre | nombre[]

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

• moveProperties

  objet

  • index

    number

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

  • windowId

    number facultatif

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

• rappel

  fonction facultatif

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

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

  • onglets

    Onglet | Onglet[]

    Informations sur les onglets déplacés.

Renvoie

• Promise<Onglet | Onglet[]>

  Chrome 88 ou version ultérieure

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

query()

Promesse

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

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

Paramètres

• queryInfo

  objet

  • actif

    booléen facultatif

    Indique si les onglets sont actifs dans leurs fenêtres.

  • audible

    booléen facultatif

    Chrome 45 et versions ultérieures

    Indique si les onglets sont audibles.

  • autoDiscardable

    booléen facultatif

    Chrome 54 ou version ultérieure

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

  • currentWindow

    booléen facultatif

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

  • avez supprimé

    booléen facultatif

    Chrome 54 ou version ultérieure

    Indique si les onglets sont supprimés. Un onglet supprimé est un onglet dont le contenu a été supprimé de la mémoire, mais qui reste visible dans la barre d'onglets. Son contenu est réactualisé la prochaine fois qu'il est activé.

  • figé

    booléen facultatif

    En attente

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

  • groupId

    number facultatif

    Chrome 88 ou version ultérieure

    ID du groupe auquel appartiennent les onglets, ou tabGroups.TAB_GROUP_ID_NONE pour les onglets non regroupés.

  • en surbrillance

    booléen facultatif

    Indique si les onglets sont mis en surbrillance.

  • index

    number facultatif

    Position des onglets dans leurs fenêtres.

  • lastFocusedWindow

    booléen facultatif

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

  • son coupé

    booléen facultatif

    Chrome 45 et versions ultérieures

    Indique si le son des onglets est coupé.

  • épinglé

    booléen facultatif

    Indique si les onglets sont épinglés.

  • état

    TabStatus facultatif

    État du chargement de l'onglet.

  • titre

    chaîne facultatif

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

  • url

    chaîne | chaîne[] facultatif

    Faites correspondre les onglets à un ou plusieurs modèles 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

    number facultatif

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

  • windowType

    WindowType facultatif

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

• rappel

  fonction facultatif

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

  (result: Tab[]) => void

  • résultat

    Onglet[]

Renvoie

• Promise<Tab[]>

  Chrome 88 ou version ultérieure

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

reload()

Promesse

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

Actualisez un onglet.

Paramètres

• tabId

  number facultatif

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

• reloadProperties

  objet facultatif

  • bypassCache

    booléen facultatif

    Indique si la mise en cache locale doit être ignorée. La valeur par défaut est false.

• rappel

  fonction facultatif

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

  () => void

Renvoie

• Promise<void>

  Chrome 88 ou version ultérieure

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

remove()

Promesse

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

Ferme un ou plusieurs onglets.

Paramètres

• tabIds

  nombre | nombre[]

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

• rappel

  fonction facultatif

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

  () => void

Renvoie

• Promise<void>

  Chrome 88 ou version ultérieure

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

sendMessage()

Promesse

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

Envoie un 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 en cours.

Paramètres

• tabId

  number

• message

  tous

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

• options

  objet facultatif

  • documentId

    chaîne facultatif

    Chrome 106 ou version ultérieure

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

  • frameId

    number facultatif

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

• rappel

  fonction facultatif

  Chrome 99 et versions ultérieures

  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

• Promise<any>

  Chrome 99 et versions ultérieures

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

setZoom()

Promesse

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

Fait un zoom sur un onglet spécifié.

Paramètres

• tabId

  number facultatif

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

• zoomFactor

  number

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

• rappel

  fonction facultatif

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

  () => void

Renvoie

• Promise<void>

  Chrome 88 ou version ultérieure

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

setZoomSettings()

Promesse

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

Définit les paramètres de zoom pour un onglet spécifié, qui définissent la manière dont les modifications de zoom sont gérées. Ces paramètres sont réinitialisés aux valeurs par défaut lorsque vous accédez à l'onglet.

Paramètres

• tabId

  number facultatif

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

• zoomSettings

  ZoomSettings

  Définit la manière dont les modifications de zoom sont gérées et leur portée.

• rappel

  fonction facultatif

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

  () => void

Renvoie

• Promise<void>

  Chrome 88 ou version ultérieure

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

ungroup()

Promise Chrome 88 et versions ultérieures

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

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

Paramètres

• tabIds

  nombre | [nombre, ...nombre[]]

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

• rappel

  fonction facultatif

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

  () => void

Renvoie

• Promise<void>

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

update()

Promesse

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

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

Paramètres

• tabId

  number facultatif

  Correspond par défaut à l'onglet sélectionné de la fenêtre actuelle.

• updateProperties

  objet

  • actif

    booléen facultatif

    Indique si l'onglet doit être actif. N'a pas d'incidence sur la sélection de la fenêtre (voir windows.update).

  • autoDiscardable

    booléen facultatif

    Chrome 54 ou version ultérieure

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

  • en surbrillance

    booléen facultatif

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

  • son coupé

    booléen facultatif

    Chrome 45 et versions ultérieures

    Indique si l'onglet doit être coupé.

  • openerTabId

    number facultatif

    ID de l'onglet qui a ouvert cet onglet. Si cette propriété est spécifiée, l'onglet d'ouverture doit se trouver dans la même fenêtre que cet onglet.

  • épinglé

    booléen facultatif

    Indique si l'onglet doit être épinglé.

  • sélectionné

    booléen facultatif

    Obsolète

    Veuillez utiliser en surbrillance.

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

  • url

    chaîne facultatif

    URL vers laquelle rediriger l'onglet. Les URL JavaScript ne sont pas acceptées. Utilisez plutôt scripting.executeScript.

• rappel

  fonction facultatif

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

  (tab?: Tab) => void

  • tabulation

    Onglet facultatif

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

Renvoie

• Promise<Tab | undefined>

  Chrome 88 ou version ultérieure

  Les promesses sont compatibles avec la version 3 du fichier manifeste et les versions ultérieures, mais des rappels sont fournis pour assurer la rétrocompatibilité. Vous ne pouvez pas utiliser les deux dans le même appel de fonction. La promesse se résout 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 d'une fenêtre change. Notez que l'URL de l'onglet peut ne pas être définie au moment du déclenchement de cet événement, mais vous pouvez écouter les événements onUpdated pour ê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

      number

      ID de l'onglet devenu actif.

    • windowId

      number

      ID de la fenêtre dans laquelle l'onglet actif a été modifié.

onAttached

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

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

Paramètres

• rappel

  fonction

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

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

  • tabId

    number

  • attachInfo

    objet

    • newPosition

      number

    • newWindowId

      number

onCreated

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

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

Paramètres

• rappel

  fonction

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

  (tab: Tab) => void

  • tabulation

    Tabulation

onDetached

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

Déclenché lorsqu'un onglet est dissocié d'une fenêtre, par exemple s'il a été déplacé d'une fenêtre à une autre.

Paramètres

• rappel

  fonction

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

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

  • tabId

    number

  • detachInfo

    objet

    • oldPosition

      number

    • oldWindowId

      number

onHighlighted

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

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

Paramètres

• rappel

  fonction

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

  (highlightInfo: object) => void

  • highlightInfo

    objet

    • tabIds

      number[]

      Tous les onglets mis en surbrillance dans la fenêtre.

    • windowId

      number

      Fenêtre dont les onglets ont changé.

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 à l'onglet déplacé manuellement. Cet événement n'est pas déclenché lorsqu'un onglet est déplacé d'une fenêtre à une autre. Pour en savoir plus, consultez tabs.onDetached.

Paramètres

• rappel

  fonction

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

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

  • tabId

    number

  • moveInfo

    objet

    • fromIndex

      number

    • toIndex

      number

    • windowId

      number

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

    number

  • removeInfo

    objet

    • isWindowClosing

      booléen

      "True" lorsque l'onglet a été fermé parce que sa fenêtre parente a été fermée.

    • windowId

      number

      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

    number

  • removedTabId

    number

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

    number

  • changeInfo

    objet

    • audible

      booléen facultatif

      Chrome 45 et versions ultérieures

      Nouvel état audible de l'onglet.

    • autoDiscardable

      booléen facultatif

      Chrome 54 ou version ultérieure

      Nouvel état de suppression automatique de l'onglet.

    • avez supprimé

      booléen facultatif

      Chrome 54 ou version ultérieure

      Nouvel état de suppression de l'onglet.

    • favIconUrl

      chaîne facultatif

      Nouvelle URL du favicon de l'onglet.

    • figé

      booléen facultatif

      En attente

      Nouvel état de l'onglet congelé.

    • groupId

      number facultatif

      Chrome 88 ou version ultérieure

      Nouveau groupe de l'onglet.

    • mutedInfo

      MutedInfo facultatif

      Chrome 46 ou version ultérieure

      Nouvel état de mise en sourdine de l'onglet et motif du changement

    • épinglé

      booléen facultatif

      Nouvel état épinglé de l'onglet.

    • état

      TabStatus facultatif

      État de chargement de l'onglet.

    • titre

      chaîne facultatif

      Chrome 48 ou version ultérieure

      Nouveau titre de l'onglet.

    • url

      chaîne facultatif

      URL de l'onglet si elle a changé.

  • tabulation

    Tabulation

onZoomChange

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

Déclenché lorsqu'un onglet est mis en zoom.

Paramètres

• rappel

  fonction

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

  (ZoomChangeInfo: object) => void

  • ZoomChangeInfo

    objet

    • newZoomFactor

      number

    • oldZoomFactor

      number

    • tabId

      number

    • zoomSettings

      ZoomSettings