browser.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+ browser.* da Chrome 148 MV3+

Tipi

Color

Il colore del gruppo.

Enum

"grey"

"blue"

"red"

"yellow"

"green"

"pink"

"purple"

"cyan"

"orange"

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.

  • condiviso

    booleano

    Chrome 137+ browser.* da Chrome 148

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

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

Recupera i dettagli del gruppo specificato.

Parametri

  • groupId

    numero

Resi

  • Promise<TabGroup>

    Browser Chrome 90 e versioni successive .* da Chrome 148

move()

browser.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 optional

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

Resi

  • Promise<TabGroup | undefined>

    Browser Chrome 90 e versioni successive .* da Chrome 148

query()

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

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

Parametri

  • queryInfo

    oggetto

    • compressa

      boolean facoltativo

      Se i gruppi sono compressi.

    • colore

      Color facoltativo

      Il colore dei gruppi.

    • condiviso

      boolean facoltativo

      Chrome 137+ browser.* da Chrome 148

      Se il gruppo è condiviso.

    • titolo

      stringa facoltativa

      Trova i titoli dei gruppi che corrispondono a un pattern.

    • windowId

      number optional

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

Resi

  • Promise<TabGroup[]>

    Browser Chrome 90 e versioni successive .* da Chrome 148

update()

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

      boolean facoltativo

      Indica se il gruppo deve essere compresso.

    • colore

      Color facoltativo

      Il colore del gruppo.

    • titolo

      stringa facoltativa

      Il titolo del gruppo.

Resi

  • Promise<TabGroup | undefined>

    Browser Chrome 90 e versioni successive .* da Chrome 148

Eventi

onCreated

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

browser.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 tra le finestre; 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

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

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

Attivato quando un gruppo viene aggiornato.

Parametri

  • callback

    funzione

    Il parametro callback ha il seguente aspetto: 

    (group: TabGroup) => void