chrome.tabGroups

Descripción

Usa la API de chrome.tabGroups para interactuar con el sistema de agrupamiento 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 hay en los grupos, usa la API de chrome.tabs.

Permisos

tabGroups

Disponibilidad

Chrome 89 y versiones posteriores MV3 y versiones posteriores

Tipos

Color

Color del grupo.

Enum

"gris"

"blue"

"rojo"

"amarillo"

"green"

"pink"

"purple"

"cyan"

"naranja"

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

    Color del grupo.

  • id

    número

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

  • compartido

    booleano

    Chrome 137 y versiones posteriores

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

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

Recupera detalles sobre el grupo especificado.

Parámetros

  • groupId

    número

Muestra

  • Promise<TabGroup>

    Chrome 90 y versiones posteriores

move()

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

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

Parámetros

  • groupId

    número

    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

      Es la ventana a la que se moverá el grupo. El valor predeterminado 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 "normal" de tipo windows.WindowType.

Muestra

  • Promise<TabGroup | undefined>

    Chrome 90 y versiones posteriores

query()

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

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.

    • compartido

      booleano opcional

      Chrome 137 y versiones posteriores

      Indica si el grupo se comparte.

    • título

      cadena opcional

      Compara los títulos de los grupos de coincidencias con un patrón.

    • windowId

      número opcional

      ID de la ventana principal o windows.WINDOW_ID_CURRENT para la ventana actual.

Muestra

  • Promise<TabGroup[]>

    Chrome 90 y versiones posteriores

update()

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

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

Parámetros

  • groupId

    número

    ID del grupo que se modificará.

  • updateProperties

    objeto

    • contraído

      booleano opcional

      Indica si el grupo debe contraerse.

    • color

      Color opcional

      Color del grupo.

    • título

      cadena opcional

      Es el título del grupo.

Muestra

  • Promise<TabGroup | undefined>

    Chrome 90 y versiones posteriores

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. En cambio, se quitará de una ventana y se creará 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 pestañas.

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