chrome.tabGroepen

Beschrijving

Gebruik de chrome.tabGroups API om te communiceren met het tabbladgroeperingssysteem van de browser. U kunt deze API gebruiken om tabbladgroepen in de browser te wijzigen en opnieuw in te delen. Gebruik de chrome.tabs API om tabbladen te groeperen en de groepering ervan op te heffen, of om te vragen welke tabbladen zich in groepen bevinden.

Machtigingen

tabGroups

Beschikbaarheid

Chroom 89+ MV3+

Soorten

Color

De kleur van de groep.

Enum

"grijs"

"blauw"

"rood"

"geel"

"groente"

"roze"

"paars"

"cyaan"

"oranje"

TabGroup

Eigenschappen

  • ingestort

    Booleaans

    Of de groep is ingestort. Een samengevouwen groep is een groep waarvan de tabbladen verborgen zijn.

  • kleur

    Kleur

    De kleur van de groep.

  • Identiteitskaart

    nummer

    De ID van de groep. Groeps-ID's zijn uniek binnen een browsersessie.

  • titel

    tekenreeks optioneel

    De titel van de groep.

  • vensterId

    nummer

    De ID van het venster dat de groep bevat.

Eigenschappen

TAB_GROUP_ID_NONE

Een ID die de afwezigheid van een groep vertegenwoordigt.

Waarde

-1

Methoden

get()

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

Haalt details op over de opgegeven groep.

Parameters

  • groepsID

    nummer

  • terugbellen

    functie optioneel

    De callback parameter ziet er als volgt uit: 

    (group: TabGroup) => void

Retouren

  • Beloof < TabGroup >

    Chroom 90+

    Beloften worden ondersteund in Manifest V3 en hoger, maar er zijn callbacks beschikbaar voor achterwaartse compatibiliteit. U kunt niet beide gebruiken bij dezelfde functieaanroep. De belofte wordt opgelost met hetzelfde type dat wordt doorgegeven aan de callback.

move()

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

Verplaatst de groep en al zijn tabbladen binnen het venster of naar een nieuw venster.

Parameters

  • groepsID

    nummer

    De ID van de groep die moet worden verplaatst.

  • verplaatsEigenschappen

    voorwerp

    • index

      nummer

      De positie waarnaar de groep moet worden verplaatst. Gebruik -1 om de groep aan het einde van het venster te plaatsen.

    • vensterId

      nummer optioneel

      Het venster waarnaar de groep moet worden verplaatst. Standaard ingesteld op het venster waarin de groep zich momenteel bevindt. Houd er rekening mee dat groepen alleen van en naar vensters kunnen worden verplaatst met windows.WindowType type "normal" .

  • terugbellen

    functie optioneel

    De callback parameter ziet er als volgt uit: 

    (group?: TabGroup) => void

    • groep

      Tabgroep optioneel

      Details over de verplaatste groep.

Retouren

  • Belofte< TabGroep | ongedefinieerd>

    Chroom 90+

    Beloften worden ondersteund in Manifest V3 en hoger, maar er zijn callbacks beschikbaar voor achterwaartse compatibiliteit. U kunt niet beide gebruiken bij dezelfde functieaanroep. De belofte wordt opgelost met hetzelfde type dat wordt doorgegeven aan de callback.

query()

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

Haalt alle groepen op die de opgegeven eigenschappen hebben, of alle groepen als er geen eigenschappen zijn opgegeven.

Parameters

  • vraagInfo

    voorwerp

    • ingestort

      Booleaans optioneel

      Of de groepen zijn ingestort.

    • kleur

      Kleur optioneel

      De kleur van de groepen.

    • titel

      tekenreeks optioneel

      Match groepstitels volgens een patroon.

    • vensterId

      nummer optioneel

      De ID van het bovenliggende venster, of windows.WINDOW_ID_CURRENT voor het huidige venster .

  • terugbellen

    functie optioneel

    De callback parameter ziet er als volgt uit: 

    (result: TabGroup[]) => void

Retouren

  • Beloof< TabGroup []>

    Chroom 90+

    Beloften worden ondersteund in Manifest V3 en hoger, maar er zijn callbacks beschikbaar voor achterwaartse compatibiliteit. U kunt niet beide gebruiken bij dezelfde functieaanroep. De belofte wordt opgelost met hetzelfde type dat wordt doorgegeven aan de callback.

update()

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

Wijzigt de eigenschappen van een groep. Eigenschappen die niet zijn opgegeven in updateProperties worden niet gewijzigd.

Parameters

  • groepsID

    nummer

    De ID van de groep die moet worden gewijzigd.

  • updateEigenschappen

    voorwerp

    • ingestort

      Booleaans optioneel

      Of de groep moet worden ingestort.

    • kleur

      Kleur optioneel

      De kleur van de groep.

    • titel

      tekenreeks optioneel

      De titel van de groep.

  • terugbellen

    functie optioneel

    De callback parameter ziet er als volgt uit: 

    (group?: TabGroup) => void

    • groep

      Tabgroep optioneel

      Details over de bijgewerkte groep.

Retouren

  • Belofte< TabGroep | ongedefinieerd>

    Chroom 90+

    Beloften worden ondersteund in Manifest V3 en hoger, maar er zijn callbacks beschikbaar voor achterwaartse compatibiliteit. U kunt niet beide gebruiken bij dezelfde functieaanroep. De belofte wordt opgelost met hetzelfde type dat wordt doorgegeven aan de callback.

Evenementen

onCreated

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

Wordt geactiveerd wanneer een groep wordt gemaakt.

Parameters

  • terugbellen

    functie

    De callback parameter ziet er als volgt uit: 

    (group: TabGroup) => void

onMoved

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

Wordt geactiveerd wanneer een groep binnen een venster wordt verplaatst. Verplaatsingsgebeurtenissen worden nog steeds geactiveerd voor de afzonderlijke tabbladen binnen de groep, maar ook voor de groep zelf. Deze gebeurtenis wordt niet geactiveerd wanneer een groep tussen vensters wordt verplaatst; in plaats daarvan wordt het uit het ene venster verwijderd en in een ander venster aangemaakt.

Parameters

  • terugbellen

    functie

    De callback parameter ziet er als volgt uit: 

    (group: TabGroup) => void

onRemoved

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

Wordt geactiveerd wanneer een groep wordt gesloten, rechtstreeks door de gebruiker of automatisch omdat deze geen tabbladen bevat.

Parameters

  • terugbellen

    functie

    De callback parameter ziet er als volgt uit: 

    (group: TabGroup) => void

onUpdated

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

Wordt geactiveerd wanneer een groep wordt bijgewerkt.

Parameters

  • terugbellen

    functie

    De callback parameter ziet er als volgt uit: 

    (group: TabGroup) => void