chrome.tabGroups

Description

Utilisez l'API chrome.tabGroups pour interagir avec le système de regroupement d'onglets du navigateur. Vous pouvez utiliser cette API pour modifier et réorganiser les groupes d'onglets dans le navigateur. Pour regrouper et dissocier des onglets, ou pour savoir 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

"grey"

"blue"

"red"

"yellow"

"green"

"pink"

"purple"

"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

    Total

    ID du groupe. Les ID de groupe sont uniques dans une session de navigateur.

  • partagés

    booléen

    Chrome 137 et versions ultérieures

    Indique si le groupe est partagé.

  • titre

    chaîne facultative

    Titre du groupe.

  • windowId

    Total

    ID de la fenêtre contenant le groupe.

Propriétés

TAB_GROUP_ID_NONE

ID représentant l'absence de groupe.

Valeur

-1

Méthodes

get()

chrome.tabGroups.get(
  groupId: number,
): Promise<TabGroup>

Récupère des informations sur le groupe spécifié.

Paramètres

  • groupId

    Total

Renvoie

  • Promise<TabGroup>

    Chrome 90 et versions ultérieures

move()

chrome.tabGroups.move(
  groupId: number,
  moveProperties: object,
): Promise<TabGroup | undefined>

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

Paramètres

  • groupId

    Total

    ID du groupe à déplacer.

  • moveProperties

    objet

    • index

      Total

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

    • windowId

      number facultatif

      Fenêtre vers laquelle déplacer le groupe. Par défaut, la fenêtre dans laquelle se trouve actuellement le groupe. Notez que les groupes ne peuvent être déplacés que vers et depuis des fenêtres de type windows.WindowType "normal".

Renvoie

  • Promise<TabGroup | undefined>

    Chrome 90 et versions ultérieures

query()

chrome.tabGroups.query(
  queryInfo: object,
): Promise<TabGroup[]>

Obtient tous les groupes qui possèdent les propriétés spécifiées, ou tous les groupes si aucune propriété n'est spécifiée.

Paramètres

  • queryInfo

    objet

    • réduit

      booléen facultatif

      Indique si les groupes sont réduits.

    • couleur

      Couleur facultatif

      Couleur des groupes.

    • partagés

      booléen facultatif

      Chrome 137 et versions ultérieures

      Indique si le groupe est partagé.

    • titre

      chaîne facultative

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

    • windowId

      number facultatif

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

Renvoie

  • Promise<TabGroup[]>

    Chrome 90 et versions ultérieures

update()

chrome.tabGroups.update(
  groupId: number,
  updateProperties: object,
): Promise<TabGroup | undefined>

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

Paramètres

  • groupId

    Total

    ID du groupe à modifier.

  • updateProperties

    objet

    • réduit

      booléen facultatif

      Indique si le groupe doit être réduit.

    • couleur

      Couleur facultatif

      Couleur du groupe.

    • titre

      chaîne facultative

      Titre du groupe.

Renvoie

  • Promise<TabGroup | undefined>

    Chrome 90 et versions ultérieures

Événements

onCreated

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

Déclenché lorsqu'un groupe est créé.

Paramètres

  • callback

    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 ne se déclenche pas lorsqu'un groupe est déplacé d'une fenêtre à une autre. Il est supprimé d'une fenêtre et créé dans une autre.

Paramètres

  • callback

    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 parce qu'il ne contenait aucun onglet.

Paramètres

  • callback

    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

  • callback

    fonction

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

    (group: TabGroup) => void