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 che sono inserite 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

TabGroup

Proprietà

  • compressa

    boolean

    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.

  • title

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

Promessa 
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

Ritorni

  • Promise<TabGroup>

    Chrome 90 e versioni successive

    Le promesse sono supportate in Manifest V3 e versioni successive, ma vengono forniti callback per garantire la compatibilità con le versioni precedenti. Non puoi utilizzarli entrambi nella stessa chiamata di funzione. La promessa viene risolta con lo stesso tipo trasmesso al callback.

move()

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

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

      numero facoltativo

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

  • callback

    funzione facoltativa

    Il parametro callback ha il seguente aspetto: 

    (group?: TabGroup)=>void

    • gruppo

      TabGroup facoltativo

      Dettagli sul gruppo spostato.

Ritorni

  • Promessa<TabGroup|non definito>

    Chrome 90 e versioni successive

    Le promesse sono supportate in Manifest V3 e versioni successive, ma vengono forniti callback per garantire la compatibilità con le versioni precedenti. Non puoi utilizzarli entrambi nella stessa chiamata di funzione. La promessa viene risolta con lo stesso tipo trasmesso al callback.

query()

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

Restituisce tutti i gruppi che hanno le proprietà specificate o tutti i gruppi se non è specificata alcuna proprietà.

Parametri

  • queryInfo

    oggetto

    • compressa

      booleano facoltativo

      Indica se i gruppi sono compressi.

    • colore

      Colore facoltativo

      Il colore dei gruppi.

    • title

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

  • callback

    funzione facoltativa

    Il parametro callback ha il seguente aspetto: 

    (result: TabGroup[])=>void

Ritorni

  • Promise<TabGroup[]>

    Chrome 90 e versioni successive

    Le promesse sono supportate in Manifest V3 e versioni successive, ma vengono forniti callback per garantire la compatibilità con le versioni precedenti. Non puoi utilizzarli entrambi nella stessa chiamata di funzione. La promessa viene risolta con lo stesso tipo trasmesso al callback.

update()

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

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.

    • title

      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.

Ritorni

  • Promessa<TabGroup|non definito>

    Chrome 90 e versioni successive

    Le promesse sono supportate in Manifest V3 e versioni successive, ma vengono forniti callback per garantire la compatibilità con le versioni precedenti. Non puoi utilizzarli entrambi nella stessa chiamata di funzione. La promessa viene risolta con lo stesso tipo trasmesso al callback.

Eventi

onCreated

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

Attivato alla creazione di un gruppo.

Parametri

  • callback

    funzione

    Il parametro callback ha il seguente aspetto: 

    (group: TabGroup)=>void

onMoved

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

Viene 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 e per il gruppo stesso. Questo evento non viene attivato quando un gruppo viene spostato tra finestre, ma verrà 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 alcuna scheda.

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