chrome.tabGroups

Descrição

Use a API chrome.tabGroups para interagir com o sistema de agrupamento de guias do navegador. É possível usar essa API para modificar e reorganizar grupos de guias no navegador. Para agrupar e desagrupar guias ou consultar quais guias estão em grupos, use a API chrome.tabs.

Permissões

tabGroups

Disponibilidade

Chrome 89+ MV3+

Tipos

Color

A cor do grupo.

Enumeração

"cinza"

"azul"

"red"

"yellow"

"green"

"pink"

"purple"

"cyan"

"laranja"

TabGroup

Propriedades

  • fechada

    booleano

    Se o grupo está fechado. Um grupo recolhido é aquele em que as guias estão ocultas.

  • cor

    Cor

    A cor do grupo.

  • ID

    número

    ID do grupo. Os IDs de grupo são exclusivos em uma sessão do navegador.

  • compartilhada

    booleano

    Chrome 137 ou mais recente

    Se o grupo é compartilhado.

  • título

    string opcional

    O título do grupo.

  • windowId

    número

    O ID da janela que contém o grupo.

Propriedades

TAB_GROUP_ID_NONE

Um ID que representa a ausência de um grupo.

Valor

-1

Métodos

get()

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

Recupera detalhes sobre o grupo especificado.

Parâmetros

  • groupId

    número

Retorna

  • Promise<TabGroup>

    Chrome 90 ou mais recente

move()

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

Move o grupo e todas as guias dele na janela ou para uma nova janela.

Parâmetros

  • groupId

    número

    O ID do grupo a ser movido.

  • moveProperties

    objeto

    • index

      número

      A posição para onde o grupo será movido. Use -1 para colocar o grupo no final da janela.

    • windowId

      number optional

      A janela para onde o grupo será movido. O padrão é a janela em que o grupo está no momento. Os grupos só podem ser movidos para e de janelas com o tipo windows.WindowType "normal".

Retorna

  • Promise<TabGroup | undefined>

    Chrome 90 ou mais recente

query()

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

Recebe todos os grupos que têm as propriedades especificadas ou todos os grupos se nenhuma propriedade for especificada.

Parâmetros

  • queryInfo

    objeto

    • fechada

      booleano opcional

      Se os grupos estão fechados.

    • cor

      Cor opcional

      A cor dos grupos.

    • compartilhada

      booleano opcional

      Chrome 137 ou mais recente

      Se o grupo é compartilhado.

    • título

      string opcional

      Corresponda títulos de grupos a um padrão.

    • windowId

      number optional

      O ID da janela principal ou windows.WINDOW_ID_CURRENT para a janela atual.

Retorna

  • Promise<TabGroup[]>

    Chrome 90 ou mais recente

update()

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

Modifica as propriedades de um grupo. As propriedades não especificadas em updateProperties não são modificadas.

Parâmetros

  • groupId

    número

    O ID do grupo a ser modificado.

  • updateProperties

    objeto

    • fechada

      booleano opcional

      Indica se o grupo deve ser recolhido.

    • cor

      Cor opcional

      É a cor do grupo.

    • título

      string opcional

      O título do grupo.

Retorna

  • Promise<TabGroup | undefined>

    Chrome 90 ou mais recente

Eventos

onCreated

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

Disparado quando um grupo é criado.

Parâmetros

  • callback

    função

    O parâmetro callback tem esta aparência: 

    (group: TabGroup) => void

onMoved

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

Disparado quando um grupo é movido em uma janela. Os eventos de movimentação ainda são disparados para as guias individuais dentro do grupo, bem como para o próprio grupo. Esse evento não é acionado quando um grupo é movido entre janelas. Em vez disso, ele é removido de uma janela e criado em outra.

Parâmetros

  • callback

    função

    O parâmetro callback tem esta aparência: 

    (group: TabGroup) => void

onRemoved

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

Acionado quando um grupo é fechado, seja diretamente pelo usuário ou automaticamente porque não continha guias.

Parâmetros

  • callback

    função

    O parâmetro callback tem esta aparência: 

    (group: TabGroup) => void

onUpdated

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

Disparado quando um grupo é atualizado.

Parâmetros

  • callback

    função

    O parâmetro callback tem esta aparência: 

    (group: TabGroup) => void