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 ridisporre 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 e versioni successive MV3 o versioni successive

Tipi

Color

Il colore del gruppo.

Enum

"grigio"

"blu"

"rosso"

"giallo"

"verde"

"rosa"

"viola"

"ciano"

"arancione"

TabGroup

Proprietà

  • compressa

    booleano

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

  • titolo

    stringa facoltativo

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

Promesso .
chrome.tabGroups.get(
  groupId: number,
  callback?: function,
)

Recupera i dettagli sul gruppo specificato.

Parametri

  • groupId

    numero

  • callback

    funzione facoltativa

    Il parametro callback ha il seguente aspetto: 

    (group: TabGroup) => void

Resi

  • Promesso<TabGroup>

    Chrome 90 e versioni successive .

    Le promesse sono supportate in Manifest V3 e versioni successive, ma sono disponibili callback per la compatibilità con le versioni precedenti. Non puoi utilizzare entrambi nella stessa chiamata di funzione. La si risolve con lo stesso tipo passato al callback.

move()

Promesso .
chrome.tabGroups.move(
  groupId: number,
  moveProperties: object,
  callback?: function,
)

Sposta il gruppo e tutte le relative schede all'interno della relativa 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. Usa -1 per posizionare il gruppo alla fine della finestra.

    • windowId

      numero facoltativo

      La finestra in cui spostare il gruppo. Il valore predefinito è la finestra in cui si trova attualmente il gruppo. Tieni presente che i gruppi possono essere spostati solo da e verso le finestre di tipo windows.WindowType "normal".

  • callback

    funzione facoltativa

    Il parametro callback ha il seguente aspetto: 

    (group?: TabGroup) => void

    • gruppo

      TabGroup facoltativo

      Dettagli sul gruppo spostato.

Resi

  • Promesso<TabGroup | non definito>

    Chrome 90 e versioni successive .

    Le promesse sono supportate in Manifest V3 e versioni successive, ma sono disponibili callback per la compatibilità con le versioni precedenti. Non puoi utilizzare entrambi nella stessa chiamata di funzione. La si risolve con lo stesso tipo passato al callback.

query()

Promesso .
chrome.tabGroups.query(
  queryInfo: object,
  callback?: function,
)

Restituisce tutti i gruppi che hanno le proprietà specificate o tutti i gruppi se non sono specificate proprietà.

Parametri

  • queryInfo

    oggetto

    • compressa

      booleano facoltativo

      Indica se i gruppi sono compressi.

    • colore

      Colore facoltativo

      Il colore dei gruppi.

    • titolo

      stringa facoltativo

      Abbina i titoli dei gruppi a uno schema.

    • windowId

      numero facoltativo

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

  • callback

    funzione facoltativa

    Il parametro callback ha il seguente aspetto: 

    (result: TabGroup[]) => void

Resi

  • Promesso<TabGroup[]>

    Chrome 90 e versioni successive .

    Le promesse sono supportate in Manifest V3 e versioni successive, ma sono disponibili callback per la compatibilità con le versioni precedenti. Non puoi utilizzare entrambi nella stessa chiamata di funzione. La si risolve con lo stesso tipo passato al callback.

update()

Promesso .
chrome.tabGroups.update(
  groupId: number,
  updateProperties: object,
  callback?: function,
)

Modifica le proprietà di un gruppo. Le proprietà che non sono 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 facoltativo

      Il titolo del gruppo.

  • callback

    funzione facoltativa

    Il parametro callback ha il seguente aspetto: 

    (group?: TabGroup) => void

    • gruppo

      TabGroup facoltativo

      Dettagli sul gruppo aggiornato.

Resi

  • Promesso<TabGroup | non definito>

    Chrome 90 e versioni successive .

    Le promesse sono supportate in Manifest V3 e versioni successive, ma sono disponibili callback per la compatibilità con le versioni precedenti. Non puoi utilizzare entrambi nella stessa chiamata di funzione. La si risolve con lo stesso tipo passato al callback.

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 continuano a essere attivati per le singole schede all'interno del gruppo e per il gruppo stesso. Questo evento non viene attivato quando un gruppo viene spostato da una finestra all'altra. verrà rimossa da una finestra e creata 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 alcuna tabulazione.

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