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
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.
-
color
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()
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
-
grupo
-
Retorna
-
Promise<TabGroup>
Chrome 90 ou mais recentePromessas 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()
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
-
Promise<TabGroup | undefined>
Chrome 90 ou mais recentePromessas 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()
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.
-
color
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
-
resultado
TabGroup[]
-
Retorna
-
Promise<TabGroup[]>
Chrome 90 ou mais recentePromessas 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()
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.
-
color
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
-
Promise<TabGroup | undefined>
Chrome 90 ou mais recentePromessas 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
-
grupo
-
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
-
grupo
-
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
-
grupo
-
onUpdated
chrome.tabGroups.onUpdated.addListener(
callback: function,
)
Disparado quando um grupo é atualizado.