chrome.tabGroups

Descrição

Use a API chrome.tabGroups para interagir com o sistema de agrupamento de guias do navegador. Você pode usar essa API para modificar e reorganizar grupos de guias no navegador. Para agrupar e desagrupar guias ou para 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.

Tipo enumerado

TabGroup

Propriedades

  • fechada

    boolean

    Indica se o grupo está recolhido. Um grupo recolhido é um grupo cujas guias estão ocultas.

  • cor

    Cor

    A cor do grupo.

  • id

    number

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

  • title

    string opcional

    O título do grupo.

  • windowId

    number

    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()

Promessa 
chrome.tabGroups.get(
  groupId: number,
  callback?: function,
)

Recupera detalhes sobre o grupo especificado.

Parâmetros

  • groupId

    number

  • callback

    função optional

    O parâmetro callback tem esta aparência: 

    (group: TabGroup)=>void

Retorna

  • Promise<TabGroup>

    Chrome 90 ou mais recente

    Promessas são compatíveis com o Manifest V3 e versões mais recentes, mas callbacks são fornecidos para compatibilidade com versões anteriores. Não é possível usar os dois na mesma chamada de função. A promessa é resolvida com o mesmo tipo que é passado para o callback.

move()

Promessa 
chrome.tabGroups.move(
  groupId: number,
  moveProperties: object,
  callback?: function,
)

Move o grupo e todas as guias para uma nova janela ou para dentro da janela.

Parâmetros

  • groupId

    number

    O ID do grupo a ser movido.

  • moveProperties

    objeto

    • índice

      number

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

    • windowId

      número opcional

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

  • callback

    função optional

    O parâmetro callback tem esta aparência: 

    (group?: TabGroup)=>void

    • grupo

      TabGroup opcional

      Detalhes sobre o grupo movido.

Retorna

  • Prometer<TabGroup|undefined>

    Chrome 90 ou mais recente

    Promessas são compatíveis com o Manifest V3 e versões mais recentes, mas callbacks são fornecidos para compatibilidade com versões anteriores. Não é possível usar os dois na mesma chamada de função. A promessa é resolvida com o mesmo tipo que é passado para o callback.

query()

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

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

Parâmetros

  • queryInfo

    objeto

    • fechada

      booleano opcional

      Indica se os grupos estão recolhidos.

    • cor

      Cor opcional

      A cor dos grupos.

    • title

      string opcional

      Combine títulos de grupos com um padrão.

    • windowId

      número opcional

      O ID da janela mãe ou windows.WINDOW_ID_CURRENT da janela atual.

  • callback

    função optional

    O parâmetro callback tem esta aparência: 

    (result: TabGroup[])=>void

Retorna

  • Promise<TabGroup[]>

    Chrome 90 ou mais recente

    Promessas são compatíveis com o Manifest V3 e versões mais recentes, mas callbacks são fornecidos para compatibilidade com versões anteriores. Não é possível usar os dois na mesma chamada de função. A promessa é resolvida com o mesmo tipo que é passado para o callback.

update()

Promessa 
chrome.tabGroups.update(
  groupId: number,
  updateProperties: object,
  callback?: function,
)

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

Parâmetros

  • groupId

    number

    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.

    • title

      string opcional

      O título do grupo.

  • callback

    função optional

    O parâmetro callback tem esta aparência: 

    (group?: TabGroup)=>void

    • grupo

      TabGroup opcional

      Detalhes sobre o grupo atualizado.

Retorna

  • Prometer<TabGroup|undefined>

    Chrome 90 ou mais recente

    Promessas são compatíveis com o Manifest V3 e versões mais recentes, mas callbacks são fornecidos para compatibilidade com versões anteriores. Não é possível usar os dois na mesma chamada de função. A promessa é resolvida com o mesmo tipo que é passado para o callback.

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 dentro de uma janela. Os eventos de movimento ainda são acionados para guias individuais e para o próprio grupo. Este evento não é acionado quando um grupo é movido entre janelas. Em vez disso, ele será 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,
)

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

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