chrome.tabGroups

Description

Utilisez l'API chrome.tabGroups pour interagir avec le système de regroupement d'onglets du navigateur. Cette API vous permet de modifier et de réorganiser les groupes d'onglets dans le navigateur. Pour regrouper et dissocier des onglets, ou pour rechercher quels onglets se trouvent dans des groupes, utilisez l'API chrome.tabs.

Autorisations

tabGroups

Disponibilité

Chrome 89 et versions ultérieures MV3+

Types

Color

Couleur du groupe.

Énumération

"gris"

"bleu"

"rouge"

"jaune"

"vert"

"rose"

"violet"

"cyan"

"orange"

TabGroup

Propriétés

  • réduit

    booléen

    Indique si le groupe est réduit. Un groupe réduit est un groupe dont les onglets sont masqués.

  • couleur

    Couleur

    Couleur du groupe.

  • id

    Nombre

    ID du groupe. Un ID de groupe est unique au sein d'une session de navigateur.

  • titre

    chaîne facultatif

    Titre du groupe.

  • windowId

    Nombre

    ID de la fenêtre qui contient le groupe.

Propriétés

TAB_GROUP_ID_NONE

ID qui représente l'absence d'un groupe.

Valeur

-1

Méthodes

get()

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

Récupère les détails du groupe spécifié.

Paramètres

  • groupId

    Nombre

  • rappel

    function facultatif

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

    (group: TabGroup) => void

Renvoie

  • Promesse<TabGroup>

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

move()

<ph type="x-smartling-placeholder"></ph> Promesse 
chrome.tabGroups.move(
  groupId: number,
  moveProperties: object,
  callback?: function,
)

Déplace le groupe et tous ses onglets dans sa fenêtre ou vers une nouvelle fenêtre.

Paramètres

  • groupId

    Nombre

    ID du groupe à déplacer.

  • moveProperties

    objet

    • index

      Nombre

      Position vers laquelle déplacer le groupe. Utilisez -1 pour placer le groupe à la fin de la fenêtre.

    • windowId

      numéro facultatif

      Fenêtre vers laquelle déplacer le groupe. La valeur par défaut correspond à la fenêtre dans laquelle se trouve le groupe. Notez que les groupes ne peuvent être déplacés vers et depuis des fenêtres que si le type windows.WindowType est "normal".

  • rappel

    function facultatif

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

    (group?: TabGroup) => void

    • groupe

      TabGroup facultatif

      Informations sur le groupe déplacé.

Renvoie

  • Promise<TabGroup | indéfini>

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

query()

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

Récupère tous les groupes contenant les établissements spécifiés ou tous les groupes si aucun établissement n'est spécifié.

Paramètres

  • queryInfo

    objet

    • réduit

      Booléen facultatif

      Indique si les groupes sont réduits.

    • couleur

      Couleur facultatif

      Couleur des groupes.

    • titre

      chaîne facultatif

      Faites correspondre les titres des groupes à un modèle.

    • windowId

      numéro facultatif

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

  • rappel

    function facultatif

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

    (result: TabGroup[]) => void

Renvoie

  • Promesse<TabGroup[]>

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

update()

<ph type="x-smartling-placeholder"></ph> Promesse 
chrome.tabGroups.update(
  groupId: number,
  updateProperties: object,
  callback?: function,
)

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

Paramètres

  • groupId

    Nombre

    ID du groupe à modifier.

  • updateProperties

    objet

    • réduit

      Booléen facultatif

      Permet de réduire ou non le groupe.

    • couleur

      Couleur facultatif

      Couleur du groupe.

    • titre

      chaîne facultatif

      Titre du groupe.

  • rappel

    function facultatif

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

    (group?: TabGroup) => void

    • groupe

      TabGroup facultatif

      Informations sur le groupe mis à jour.

Renvoie

  • Promise<TabGroup | indéfini>

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

Événements

onCreated

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

Déclenché lors de la création d'un groupe.

Paramètres

  • rappel

    fonction

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

    (group: TabGroup) => void

onMoved

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

Déclenché lorsqu'un groupe est déplacé dans une fenêtre. Les événements de déplacement sont toujours déclenchés pour les onglets individuels du groupe, ainsi que pour le groupe lui-même. Cet événement n'est pas déclenché lorsqu'un groupe est déplacé d'une fenêtre à une autre. au lieu de cela, il est supprimé d'une fenêtre et créé dans une autre.

Paramètres

  • rappel

    fonction

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

    (group: TabGroup) => void

onRemoved

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

Déclenché lorsqu'un groupe est fermé, soit directement par l'utilisateur, soit automatiquement, car il ne contenait aucun onglet.

Paramètres

  • rappel

    fonction

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

    (group: TabGroup) => void

onUpdated

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

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

Paramètres

  • rappel

    fonction

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

    (group: TabGroup) => void