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

El color del grupo.

Enum

TabGroup

Propiedades

  • contraído

    boolean

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

  • color [color]

    Color

    El color del grupo.

  • id

    número

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

  • title

    cadena opcional

    Es el título del grupo.

  • windowId

    número

    El ID de la ventana que contiene el grupo.

Propiedades

TAB_GROUP_ID_NONE

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

Devuelve

  • Promise<TabGroup>

    Chrome 90 y versiones posteriores

    Las promesas son compatibles con Manifest V3 y versiones posteriores, pero se proporcionan devoluciones de llamada para brindar 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 las pestañas dentro de la ventana o a una ventana nueva.

Parámetros

  • groupId

    número

    El ID del grupo que se moverá.

  • moveProperties

    objeto

    • index

      número

      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

      Ventana a la que se moverá el grupo. La configuración predeterminada es la ventana en la que se encuentra el grupo actualmente. Ten en cuenta que los grupos solo se pueden mover hacia y desde ventanas con windows.WindowType tipo "normal".

  • 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ó.

Devuelve

  • Promesa<TabGroup|undefined>

    Chrome 90 y versiones posteriores

    Las promesas son compatibles con Manifest V3 y versiones posteriores, pero se proporcionan devoluciones de llamada para brindar 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 especificaron propiedades.

Parámetros

  • queryInfo

    objeto

    • contraído

      booleano opcional

      Indica si los grupos están contraídos.

    • color [color]

      Color opcional

      El color de los grupos.

    • title

      cadena opcional

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

    • windowId

      número opcional

      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

Devuelve

  • Promise<TabGroup[]>

    Chrome 90 y versiones posteriores

    Las promesas son compatibles con Manifest V3 y versiones posteriores, pero se proporcionan devoluciones de llamada para brindar 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. No se modifican las propiedades que no se especifican en updateProperties.

Parámetros

  • groupId

    número

    El ID del grupo que se modificará.

  • updateProperties

    objeto

    • contraído

      booleano opcional

      Indica si se debe contraer el grupo.

    • color [color]

      Color opcional

      El color del grupo.

    • title

      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.

Devuelve

  • Promesa<TabGroup|undefined>

    Chrome 90 y versiones posteriores

    Las promesas son compatibles con Manifest V3 y versiones posteriores, pero se proporcionan devoluciones de llamada para brindar 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

    la 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 un grupo se mueve dentro de una ventana. Los eventos de movimiento se seguirán activando para las pestañas individuales del grupo y para el grupo en sí. Este evento no se activa cuando un grupo se mueve entre ventanas; en cambio, se quitará de una ventana y se creará en otra.

Parámetros

  • callback

    la 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 contiene pestañas.

Parámetros

  • callback

    la 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

    la función

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

    (group: TabGroup)=>void