browser.tabGroups

Beschrijving

Gebruik de chrome.tabGroups API om te communiceren met het systeem voor tabbladgroepering van de browser. Je kunt deze API gebruiken om tabbladgroepen in de browser aan te passen en opnieuw te rangschikken. Gebruik de chrome.tabs API om tabbladen te groeperen en de groepering ongedaan te maken, of om op te vragen welke tabbladen zich in groepen bevinden.

Rechten

tabGroups

Beschikbaarheid

Chrome 89+ browser.* sinds Chrome 148 MV3+

Typen

Color

De kleur van de groep.

Enum

"grey"

"blue"

"red"

"yellow"

'green'

'pink'

"purple"

"cyan"

"orange"

TabGroup

Eigenschappen

  • samengevouwen

    booleaans

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

  • kleur

    Kleur

    De kleur van de groep.

  • id

    getal

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

  • gedeeld

    booleaans

    Chrome 137+ browser.* sinds Chrome 148

    Of de groep is gedeeld.

  • titel

    tekenreeks optioneel

    De titel van de groep.

  • windowId

    getal

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

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

Hiermee worden gegevens over de opgegeven groep opgehaald.

Parameters

  • groupId

    getal

Retourzendingen

  • Promise<TabGroup>

    Chrome 90 of hoger browser.* sinds Chrome 148

move()

browser.tabGroups.move(
  groupId: number,
  moveProperties: object,
): Promise<TabGroup | undefined>

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

Parameters

  • groupId

    getal

    De ID van de groep die je wilt verplaatsen.

  • moveProperties

    object

    • index

      getal

      De positie waarnaar je de groep wilt verplaatsen. Gebruik -1 om de groep aan het einde van het venster te plaatsen.

    • windowId

      number optioneel

      Het venster waarnaar je de groep wilt verplaatsen. Standaard is dit het venster waarin de groep zich op dat moment bevindt. Groepen kunnen alleen worden verplaatst naar en van vensters met het type windows.WindowType "normal".

Retourzendingen

  • Promise<TabGroup | undefined>

    Chrome 90 of hoger browser.* sinds Chrome 148

query()

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

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

Parameters

  • queryInfo

    object

    • samengevouwen

      booleaans optioneel

      Of de groepen zijn samengevouwen.

    • kleur

      Kleur optioneel

      De kleur van de groepen.

    • gedeeld

      booleaans optioneel

      Chrome 137+ browser.* sinds Chrome 148

      Of de groep is gedeeld.

    • titel

      tekenreeks optioneel

      Vergelijk groepstitels met een patroon.

    • windowId

      number optioneel

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

Retourzendingen

  • Promise<TabGroup[]>

    Chrome 90 of hoger browser.* sinds Chrome 148

update()

browser.tabGroups.update(
  groupId: number,
  updateProperties: object,
): Promise<TabGroup | undefined>

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

Parameters

  • groupId

    getal

    De ID van de groep die je wilt aanpassen.

  • updateProperties

    object

    • samengevouwen

      booleaans optioneel

      Of de groep moet worden samengevouwen.

    • kleur

      Kleur optioneel

      De kleur van de groep.

    • titel

      tekenreeks optioneel

      De titel van de groep.

Retourzendingen

  • Promise<TabGroup | undefined>

    Chrome 90 of hoger browser.* sinds Chrome 148

Evenementen

onCreated

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

Wordt geactiveerd als er een groep wordt gemaakt.

Parameters

  • callback

    functie

    De parameter callback ziet er zo uit: 

    (group: TabGroup) => void

onMoved

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

Wordt geactiveerd als een groep binnen een venster wordt verplaatst. Verplaatsingsgebeurtenissen worden nog steeds geactiveerd voor de afzonderlijke tabbladen in de groep en voor de groep zelf. Deze gebeurtenis wordt niet geactiveerd als een groep tussen vensters wordt verplaatst. In plaats daarvan wordt de groep uit het ene venster verwijderd en in een ander venster gemaakt.

Parameters

  • callback

    functie

    De parameter callback ziet er zo uit: 

    (group: TabGroup) => void

onRemoved

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

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

Parameters

  • callback

    functie

    De parameter callback ziet er zo uit: 

    (group: TabGroup) => void

onUpdated

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

Wordt geactiveerd als een groep wordt geüpdatet.

Parameters

  • callback

    functie

    De parameter callback ziet er zo uit: 

    (group: TabGroup) => void