chrome.tabGroups

Descripción

Usa la API de chrome.tabGroups para interactuar con el sistema de agrupación de pestañas del navegador. Puedes usar esta API para modificar y reorganizar los grupos de pestañas en el navegador. Para agrupar y desagrupar pestañas, o para consultar qué pestañas están en grupos, usa la API de chrome.tabs.

Permisos

tabGroups

Disponibilidad

Chrome 89 y versiones posteriores MV3 y versiones posteriores

Tipos

Color

Es el color del grupo.

Enum

"grey"

"blue"

"red"

"yellow"

"green"

"pink"

"purple"

"cyan"

"orange"

TabGroup

Propiedades

  • contraído

    booleano

    Indica si el grupo está contraído. Un grupo contraído es aquel cuyas pestañas están ocultas.

  • color

    Color

    Es el color del grupo.

  • id

    número

    Es el ID del grupo. Los IDs de grupo son únicos dentro de una sesión del navegador.

  • compartidos

    booleano

    Pendiente

    Indica si el grupo se comparte.

  • título

    cadena opcional

    Es el título del grupo.

  • windowId

    número

    Es el ID de la ventana que contiene el grupo.

Propiedades

TAB_GROUP_ID_NONE

Es un ID que representa la ausencia de un grupo.

Valor

-1

Métodos

get()

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

Recupera detalles sobre el grupo especificado.

Parámetros

  • groupId

    número

  • callback

    función opcional

    El parámetro callback se ve de la siguiente manera: 

    (group: TabGroup) => void

Muestra

  • Promise<TabGroup>

    Chrome 90 y versiones posteriores

    Las promesas son compatibles con el manifiesto V3 y versiones posteriores, pero se proporcionan devoluciones de llamada para la retrocompatibilidad. No puedes usar ambos en la misma llamada a función. La promesa se resuelve con el mismo tipo que se pasa a la devolución de llamada.

move()

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

Mueve el grupo y todas sus pestañas dentro de su ventana o a una ventana nueva.

Parámetros

  • groupId

    número

    Es el ID del grupo que se moverá.

  • moveProperties

    objeto

    • índice

      número

      Es la posición a la que se moverá el grupo. Usa -1 para colocar el grupo al final de la ventana.

    • windowId

      número opcional

      La ventana a la que se moverá el grupo. El valor predeterminado es la ventana en la que se encuentra el grupo. Ten en cuenta que los grupos solo se pueden mover desde y hacia ventanas con el tipo "normal" de windows.WindowType.

  • callback

    función opcional

    El parámetro callback se ve de la siguiente manera: 

    (group?: TabGroup) => void

    • grupo

      TabGroup opcional

      Detalles sobre el grupo que se movió

Muestra

  • Promise<TabGroup | undefined>

    Chrome 90 y versiones posteriores

    Las promesas son compatibles con el manifiesto V3 y versiones posteriores, pero se proporcionan devoluciones de llamada para la retrocompatibilidad. No puedes usar ambos en la misma llamada a función. La promesa se resuelve con el mismo tipo que se pasa a la devolución de llamada.

query()

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

Obtiene todos los grupos que tienen las propiedades especificadas o todos los grupos si no se especifican propiedades.

Parámetros

  • queryInfo

    objeto

    • contraído

      booleano opcional

      Indica si los grupos están contraídos.

    • color

      Color opcional

      Es el color de los grupos.

    • compartidos

      booleano opcional

      Pendiente

      Indica si el grupo se comparte.

    • título

      cadena opcional

      Hacer coincidir los títulos de los grupos con un patrón

    • windowId

      número opcional

      Es el ID de la ventana superior o windows.WINDOW_ID_CURRENT para la ventana actual.

  • callback

    función opcional

    El parámetro callback se ve de la siguiente manera: 

    (result: TabGroup[]) => void

Muestra

  • Promise<TabGroup[]>

    Chrome 90 y versiones posteriores

    Las promesas son compatibles con el manifiesto V3 y versiones posteriores, pero se proporcionan devoluciones de llamada para la retrocompatibilidad. No puedes usar ambos en la misma llamada a función. La promesa se resuelve con el mismo tipo que se pasa a la devolución de llamada.

update()

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

Modifica las propiedades de un grupo. Las propiedades que no se especifican en updateProperties no se modifican.

Parámetros

  • groupId

    número

    Es el ID del grupo que se modificará.

  • updateProperties

    objeto

    • contraído

      booleano opcional

      Indica si se debe contraer el grupo.

    • color

      Color opcional

      Es el color del grupo.

    • título

      cadena opcional

      Es el título del grupo.

  • callback

    función opcional

    El parámetro callback se ve de la siguiente manera: 

    (group?: TabGroup) => void

    • grupo

      TabGroup opcional

      Detalles sobre el grupo actualizado.

Muestra

  • Promise<TabGroup | undefined>

    Chrome 90 y versiones posteriores

    Las promesas son compatibles con el manifiesto V3 y versiones posteriores, pero se proporcionan devoluciones de llamada para la retrocompatibilidad. No puedes usar ambos en la misma llamada a función. La promesa se resuelve con el mismo tipo que se pasa a la devolución de llamada.

Eventos

onCreated

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

Se activa cuando se crea un grupo.

Parámetros

  • callback

    función

    El parámetro callback se ve de la siguiente manera: 

    (group: TabGroup) => void

onMoved

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

Se activa cuando se mueve un grupo dentro de una ventana. Los eventos de movimiento se siguen activando para las pestañas individuales dentro del grupo, así como para el grupo en sí. Este evento no se activa cuando se mueve un grupo entre ventanas, sino que se quita de una ventana y se crea en otra.

Parámetros

  • callback

    función

    El parámetro callback se ve de la siguiente manera: 

    (group: TabGroup) => void

onRemoved

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

Se activa cuando se cierra un grupo, ya sea directamente por el usuario o automáticamente porque no contenía ninguna pestaña.

Parámetros

  • callback

    función

    El parámetro callback se ve de la siguiente manera: 

    (group: TabGroup) => void

onUpdated

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

Se activa cuando se actualiza un grupo.

Parámetros

  • callback

    función

    El parámetro callback se ve de la siguiente manera: 

    (group: TabGroup) => void