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à
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.
-
color
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()
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
-
gruppo
-
Ritorni
-
Promise<TabGroup>
Chrome 90 e versioni successiveLe 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()
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
-
Promise<TabGroup | undefined>
Chrome 90 e versioni successiveLe 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()
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.
-
color
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
-
risultato
TabGroup[]
-
Ritorni
-
Promise<TabGroup[]>
Chrome 90 e versioni successiveLe 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()
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.
-
color
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
-
Promise<TabGroup | undefined>
Chrome 90 e versioni successiveLe 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
-
gruppo
-
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
-
gruppo
-
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
-
gruppo
-
onUpdated
chrome.tabGroups.onUpdated.addListener(
callback: function,
)
Attivato quando un gruppo viene aggiornato.