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 te ordenen. Gebruik de chrome.tabs API om tabbladen te groeperen en degroeperen, of om op te vragen welke tabbladen in groepen zitten.

Machtigingen

tabGroups

Beschikbaarheid

Chroom 89+ MV3+

Typen

Color

De kleur van de groep.

Enum

"grijs"

"blauw"

"rood"

"geel"

"groente"

"roze"

"paars"

"cyaan"

"oranje"

TabGroup

Eigenschappen

  • ingestort

    Booleaanse

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

  • kleur

    Kleur

    De kleur van de groep.

  • id

    nummer

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

  • gedeeld

    Booleaanse

    Chroom 137+

    Of de groep gedeeld is.

  • titel

    string optioneel

    De titel van de groep.

  • venster-ID

    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

  • groeps-ID

    nummer

  • terugbellen

    functie optioneel

    De callback parameter ziet er als volgt uit: 

    (group: TabGroup) => void

Retourneren

  • Belofte< TabGroup >

    Chroom 90+

    Promises worden ondersteund in Manifest V3 en later, maar callbacks worden meegeleverd voor achterwaartse compatibiliteit. U kunt niet beide in dezelfde functieaanroep gebruiken. De promise wordt omgezet met hetzelfde type dat aan de callback wordt doorgegeven.

move()

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

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

Parameters

  • groeps-ID

    nummer

    De ID van de groep die verplaatst moet worden.

  • moveProperties

    voorwerp

    • index

      nummer

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

    • venster-ID

      nummer optioneel

      Het venster waarnaar de groep moet worden verplaatst. Standaard is dit het venster waarin de groep zich momenteel bevindt. Let op: groepen kunnen alleen van en naar vensters worden verplaatst met windows.WindowType van het type "normal" .

  • terugbellen

    functie optioneel

    De callback parameter ziet er als volgt uit: 

    (group?: TabGroup) => void

    • groep

      TabGroup optioneel

      Gegevens over de verplaatste groep.

Retourneren

  • Belofte< TabGroup | undefined>

    Chroom 90+

    Promises worden ondersteund in Manifest V3 en later, maar callbacks worden meegeleverd voor achterwaartse compatibiliteit. U kunt niet beide in dezelfde functieaanroep gebruiken. De promise wordt omgezet met hetzelfde type dat aan de callback wordt doorgegeven.

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

  • queryInfo

    voorwerp

    • ingestort

      boolean optioneel

      Of de groepen zijn samengevouwen.

    • kleur

      Kleur optioneel

      De kleur van de groepen.

    • gedeeld

      boolean optioneel

      Chroom 137+

      Of de groep gedeeld is.

    • titel

      string optioneel

      Koppel groepstitels aan een patroon.

    • venster-ID

      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

Retourneren

  • Belofte< TabGroup []>

    Chroom 90+

    Promises worden ondersteund in Manifest V3 en later, maar callbacks worden meegeleverd voor achterwaartse compatibiliteit. U kunt niet beide in dezelfde functieaanroep gebruiken. De promise wordt omgezet met hetzelfde type dat aan de callback wordt doorgegeven.

update()

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

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

Parameters

  • groeps-ID

    nummer

    De ID van de groep die u wilt wijzigen.

  • update-eigenschappen

    voorwerp

    • ingestort

      boolean optioneel

      Of de groep moet worden samengevouwen.

    • kleur

      Kleur optioneel

      De kleur van de groep.

    • titel

      string optioneel

      De titel van de groep.

  • terugbellen

    functie optioneel

    De callback parameter ziet er als volgt uit: 

    (group?: TabGroup) => void

    • groep

      TabGroup optioneel

      Details over de bijgewerkte groep.

Retourneren

  • Belofte< TabGroup | undefined>

    Chroom 90+

    Promises worden ondersteund in Manifest V3 en later, maar callbacks worden meegeleverd voor achterwaartse compatibiliteit. U kunt niet beide in dezelfde functieaanroep gebruiken. De promise wordt omgezet met hetzelfde type dat aan de callback wordt doorgegeven.

Evenementen

onCreated

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

Wordt geactiveerd wanneer een groep wordt aangemaakt.

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, evenals voor de groep zelf. Deze gebeurtenis wordt niet geactiveerd wanneer een groep tussen vensters wordt verplaatst; in plaats daarvan wordt de groep 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, hetzij rechtstreeks door de gebruiker, hetzij automatisch omdat de groep 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