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

Tipos

Color

El color del grupo.

Enum

“gris”

“azul”

“rojo”

“amarillo”

“verde”

“rosa”

“púrpura”

“cian”

“naranja”

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

    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.

  • título

    string 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

Muestra

  • Promesa<TabGroup>

    Chrome 90 y versiones posteriores

    Las promesas son compatibles con Manifest V3 y versiones posteriores, pero se proporcionan devoluciones de llamada para retrocompatibilidad. No puedes usar ambos en la misma llamada a función. El 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

    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

      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 solo se pueden mover grupos desde y hacia ventanas con windows.WindowType de 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ó.

Muestra

  • Promise<TabGroup | indefinido>

    Chrome 90 y versiones posteriores

    Las promesas son compatibles con Manifest V3 y versiones posteriores, pero se proporcionan devoluciones de llamada para retrocompatibilidad. No puedes usar ambos en la misma llamada a función. El 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

      El color de los grupos.

    • título

      string opcional

      Haz 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

  • Promesa<TabGroup[]>

    Chrome 90 y versiones posteriores

    Las promesas son compatibles con Manifest V3 y versiones posteriores, pero se proporcionan devoluciones de llamada para retrocompatibilidad. No puedes usar ambos en la misma llamada a función. El 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

    El ID del grupo que se modificará.

  • updateProperties

    objeto

    • contraído

      booleano opcional

      Indica si el grupo debe contraerse.

    • color

      Color opcional

      Indica el color del grupo.

    • título

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

    Chrome 90 y versiones posteriores

    Las promesas son compatibles con Manifest V3 y versiones posteriores, pero se proporcionan devoluciones de llamada para retrocompatibilidad. No puedes usar ambos en la misma llamada a función. El 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 un grupo se mueve dentro de una ventana. De todos modos, los eventos de movimiento se activan 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. sino que 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 contiene 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