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 incluse nei gruppi, utilizza l'API chrome.tabs
.
Autorizzazioni
tabGroups
Disponibilità
Tipi
Color
Il colore del gruppo.
Enum
"grey"
"blue"
"red"
"yellow"
"green"
"pink"
"purple"
"cyan"
"arancia"
TabGroup
Proprietà
-
compressa
booleano
Indica se il gruppo è compresso. Un gruppo compresso è un gruppo le cui schede sono nascoste.
-
colore
Il colore del gruppo.
-
id
numero
L'ID del gruppo. Gli ID gruppo sono univoci all'interno di una sessione del browser.
-
booleano
In attesaIndica 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,
callback?: function,
)
Recupera i dettagli del gruppo specificato.
Parametri
-
groupId
numero
-
callback
function facoltativa
Il parametro
callback
ha il seguente aspetto:(group: TabGroup) => void
-
gruppo
-
Resi
-
Promise<TabGroup>
Chrome 90 o versioni successiveLe promesse sono supportate in Manifest V3 e versioni successive, ma i callback vengono forniti per la compatibilità con le versioni precedenti. Non puoi utilizzarle entrambe nella stessa chiamata di funzione. La promessa viene risolta con lo stesso tipo passato 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
number facoltativo
La finestra in cui spostare il gruppo. Per impostazione predefinita, viene utilizzata la finestra in cui si trova il gruppo. Tieni presente che i gruppi possono essere spostati solo verso e da finestre con tipo
"normal"
windows.WindowType
.
-
-
callback
function facoltativa
Il parametro
callback
ha il seguente aspetto:(group?: TabGroup) => void
-
gruppo
TabGroup facoltativo
Dettagli sul gruppo spostato.
-
Resi
-
Promise<TabGroup | undefined>
Chrome 90 o versioni successiveLe promesse sono supportate in Manifest V3 e versioni successive, ma i callback vengono forniti per la compatibilità con le versioni precedenti. Non puoi utilizzarle entrambe nella stessa chiamata di funzione. La promessa viene risolta con lo stesso tipo passato al callback.
query()
chrome.tabGroups.query(
queryInfo: object,
callback?: function,
)
Restituisce 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.
-
booleano facoltativo
In attesaIndica se il gruppo è condiviso.
-
titolo
stringa facoltativa
Abbina i titoli dei gruppi a un pattern.
-
windowId
number facoltativo
L'ID della finestra principale o
windows.WINDOW_ID_CURRENT
per la finestra corrente.
-
-
callback
function facoltativa
Il parametro
callback
ha il seguente aspetto:(result: TabGroup[]) => void
-
risultato
TabGroup[]
-
Resi
-
Promise<TabGroup[]>
Chrome 90 o versioni successiveLe promesse sono supportate in Manifest V3 e versioni successive, ma i callback vengono forniti per la compatibilità con le versioni precedenti. Non puoi utilizzarle entrambe nella stessa chiamata di funzione. La promessa viene risolta con lo stesso tipo passato 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.
-
colore
Colore facoltativo
Il colore del gruppo.
-
titolo
stringa facoltativa
Il titolo del gruppo.
-
-
callback
function facoltativa
Il parametro
callback
ha il seguente aspetto:(group?: TabGroup) => void
-
gruppo
TabGroup facoltativo
Dettagli sul gruppo aggiornato.
-
Resi
-
Promise<TabGroup | undefined>
Chrome 90 o versioni successiveLe promesse sono supportate in Manifest V3 e versioni successive, ma i callback vengono forniti per la compatibilità con le versioni precedenti. Non puoi utilizzarle entrambe nella stessa chiamata di funzione. La promessa viene risolta con lo stesso tipo passato al callback.
Eventi
onCreated
chrome.tabGroups.onCreated.addListener(
callback: function,
)
Viene attivato quando viene creato 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, nonché per il gruppo stesso. Questo evento non viene attivato quando un gruppo viene spostato da una finestra all'altra, ma viene 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,
)
Viene 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
-
gruppo
-
onUpdated
chrome.tabGroups.onUpdated.addListener(
callback: function,
)
Viene attivato quando un gruppo viene aggiornato.