chrome.tabGroups

Descrizione

Utilizza l'API chrome.tabGroups per interagire con il sistema di raggruppamento delle schede del browser. Puoi utilizzare questa API per modificare e riorganizzare i gruppi di schede nel browser. Per raggruppare e separare le schede o per eseguire query sulle schede presenti nei gruppi, utilizza l'API chrome.tabs.

Autorizzazioni

tabGroups

Disponibilità

Chrome 89+ MV3+

Tipi

Color

Il colore del gruppo.

Enum

"grigio"

"blue"

"red"

"yellow"

"green"

"pink"

"purple"

"cyan"

"orange"

TabGroup

Proprietà

  • compressa

    booleano

    Se il gruppo è compresso. Un gruppo compresso è un gruppo le cui schede sono nascoste.

  • colore

    Colore

    Il colore del gruppo.

  • id

    numero

    L'ID del gruppo. Gli ID gruppo sono univoci all'interno di una sessione del browser.

  • condiviso

    booleano

    Chrome 137+

    Se il gruppo è condiviso.

  • titolo

    stringa facoltativa

    Il titolo del gruppo.

  • windowId

    numero

    L'ID della finestra che contiene il gruppo.

Proprietà

TAB_GROUP_ID_NONE

Un ID che rappresenta l'assenza di un gruppo.

Valore

-1

Metodi

get()

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

Recupera i dettagli del gruppo specificato.

Parametri

  • groupId

    numero

Resi

move()

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

Sposta il gruppo e tutte le relative schede all'interno della finestra o in una nuova finestra.

Parametri

  • groupId

    numero

    L'ID del gruppo da spostare.

  • moveProperties

    oggetto

    • indice

      numero

      La posizione in cui spostare il gruppo. Utilizza -1 per posizionare il gruppo alla fine della finestra.

    • windowId

      number (facoltativo)

      La finestra in cui spostare il gruppo. Per impostazione predefinita, viene visualizzata la finestra in cui si trova attualmente il gruppo. Tieni presente che i gruppi possono essere spostati solo da e verso finestre di tipo windows.WindowType "normal".

Resi

  • Promise<TabGroup | undefined>

    Chrome 90+

query()

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

Recupera tutti i gruppi con le proprietà specificate o tutti i gruppi se non vengono specificate proprietà.

Parametri

  • queryInfo

    oggetto

    • compressa

      booleano facoltativo

      Se i gruppi sono compressi.

    • colore

      Colore facoltativo

      Il colore dei gruppi.

    • condiviso

      booleano facoltativo

      Chrome 137+

      Se il gruppo è condiviso.

    • titolo

      stringa facoltativa

      Corrispondenza dei titoli dei gruppi con un pattern.

    • windowId

      number (facoltativo)

      L'ID della finestra principale o windows.WINDOW_ID_CURRENT per la finestra corrente.

Resi

update()

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

Modifica le proprietà di un gruppo. Le proprietà non specificate in updateProperties non vengono modificate.

Parametri

  • groupId

    numero

    L'ID del gruppo da modificare.

  • updateProperties

    oggetto

    • compressa

      booleano facoltativo

      Indica se il gruppo deve essere compresso.

    • colore

      Colore facoltativo

      Il colore del gruppo.

    • titolo

      stringa facoltativa

      Il titolo del gruppo.

Resi

  • Promise<TabGroup | undefined>

    Chrome 90+

Eventi

onCreated

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

Attivato quando viene creato un gruppo.

Parametri

  • callback

    funzione

    Il parametro callback ha il seguente aspetto: 

    (group: TabGroup) => void

onMoved

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

Attivato quando un gruppo viene spostato all'interno di una finestra. Gli eventi di spostamento vengono comunque attivati per le singole schede all'interno del gruppo, nonché per il gruppo stesso. Questo evento non viene attivato quando un gruppo viene spostato da una finestra all'altra. Viene invece rimosso da una finestra e creato in un'altra.

Parametri

  • callback

    funzione

    Il parametro callback ha il seguente aspetto: 

    (group: TabGroup) => void

onRemoved

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

Attivato quando un gruppo viene chiuso, direttamente dall'utente o automaticamente perché non conteneva schede.

Parametri

  • callback

    funzione

    Il parametro callback ha il seguente aspetto: 

    (group: TabGroup) => void

onUpdated

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

Attivato quando un gruppo viene aggiornato.

Parametri

  • callback

    funzione

    Il parametro callback ha il seguente aspetto: 

    (group: TabGroup) => void