browser.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 browser.* desde Chrome 148 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.

  • compartida

    booleano

    Chrome 137 y versiones posteriores browser.* desde Chrome 148

    Indica si el grupo se comparte.

  • título

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

browser.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 browser.* desde Chrome 148

move()

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

    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

      number opcional

      Es la 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 el tipo "normal" de windows.WindowType.

Muestra

  • Promise<TabGroup | undefined>

    Chrome 90 y versiones posteriores browser.* desde Chrome 148

query()

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

    • compartida

      booleano opcional

      Chrome 137 y versiones posteriores browser.* desde Chrome 148

      Indica si el grupo se comparte.

    • título

      string opcional

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

    • windowId

      number opcional

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

Muestra

  • Promise<TabGroup[]>

    Chrome 90 y versiones posteriores browser.* desde Chrome 148

update()

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

    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

      string opcional

      Es el título del grupo.

Muestra

  • Promise<TabGroup | undefined>

    Chrome 90 y versiones posteriores browser.* desde Chrome 148

Eventos

onCreated

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

browser.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 su lugar, 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

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

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