browser.tabGroups

Beschreibung

Verwenden Sie die chrome.tabGroups API, um mit dem Tabgruppen-System des Browsers zu interagieren. Mit dieser API können Sie Tabgruppen im Browser ändern und neu anordnen. Wenn Sie Tabs gruppieren, die Gruppierung aufheben oder abfragen möchten, welche Tabs sich in Gruppen befinden, verwenden Sie die chrome.tabs API.

Berechtigungen

tabGroups

Verfügbarkeit

Chrome 89 und höher browser.* seit Chrome 148 MV3 und höher

Typen

Color

Die Farbe der Gruppe.

Enum

"grey"

"blue"

"red"

"yellow"

"green"

"pink"

"purple"

"cyan"

"orange"

TabGroup

Attribute

  • Minimiert

    boolean

    Gibt an, ob die Gruppe minimiert ist. Bei einer minimierten Gruppe sind die Tabs ausgeblendet.

  • Farbe

    Farbe

    Die Farbe der Gruppe.

  • id

    Zahl

    Die ID der Gruppe. Gruppen-IDs sind innerhalb einer Browsersitzung eindeutig.

  • geteilt

    boolean

    Chrome 137 und höher browser.* seit Chrome 148

    Gibt an, ob die Gruppe freigegeben ist.

  • Titel

    String optional

    Der Titel der Gruppe.

  • windowId

    Zahl

    Die ID des Fensters, das die Gruppe enthält.

Attribute

TAB_GROUP_ID_NONE

Eine ID, die das Fehlen einer Gruppe darstellt.

Wert

-1

Methoden

get()

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

Ruft Details zur angegebenen Gruppe ab.

Parameter

  • groupId

    Zahl

Ausgabe

  • Promise<TabGroup>

    Chrome 90 und höher browser.* seit Chrome 148

move()

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

Verschiebt die Gruppe und alle ihre Tabs innerhalb des Fensters oder in ein neues Fenster.

Parameter

  • groupId

    Zahl

    Die ID der zu verschiebenden Gruppe.

  • moveProperties

    Objekt

    • Index

      Zahl

      Die Position, an die die Gruppe verschoben werden soll. Verwenden Sie -1, um die Gruppe am Ende des Fensters zu platzieren.

    • windowId

      number optional

      Das Fenster, in das die Gruppe verschoben werden soll. Standardmäßig wird das Fenster verwendet, in dem sich die Gruppe gerade befindet. Gruppen können nur in und aus Fenstern mit dem windows.WindowType-Typ "normal" verschoben werden.

Ausgabe

  • Promise<TabGroup | undefined>

    Chrome 90 und höher browser.* seit Chrome 148

query()

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

Ruft alle Gruppen mit den angegebenen Attributen ab oder alle Gruppen, wenn keine Attribute angegeben sind.

Parameter

  • queryInfo

    Objekt

    • Minimiert

      Boolesch optional

      Gibt an, ob die Gruppen minimiert sind.

    • Farbe

      Farbe optional

      Die Farbe der Gruppen.

    • geteilt

      Boolesch optional

      Chrome 137 und höher browser.* seit Chrome 148

      Gibt an, ob die Gruppe freigegeben ist.

    • Titel

      String optional

      Gruppentitel mit einem Muster abgleichen.

    • windowId

      number optional

      Die ID des übergeordneten Fensters oder windows.WINDOW_ID_CURRENT für das aktuelle Fenster.

Ausgabe

  • Promise<TabGroup[]>

    Chrome 90 und höher browser.* seit Chrome 148

update()

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

Ändert die Eigenschaften einer Gruppe. Attribute, die nicht in updateProperties angegeben sind, werden nicht geändert.

Parameter

  • groupId

    Zahl

    Die ID der zu ändernden Gruppe.

  • updateProperties

    Objekt

    • Minimiert

      Boolesch optional

      Gibt an, ob die Gruppe minimiert werden soll.

    • Farbe

      Farbe optional

      Die Farbe der Gruppe.

    • Titel

      String optional

      Der Titel der Gruppe.

Ausgabe

  • Promise<TabGroup | undefined>

    Chrome 90 und höher browser.* seit Chrome 148

Ereignisse

onCreated

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

Wird ausgelöst, wenn eine Gruppe erstellt wird.

Parameter

  • callback

    Funktion

    Der Parameter callback sieht so aus: 

    (group: TabGroup) => void

onMoved

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

Wird ausgelöst, wenn eine Gruppe innerhalb eines Fensters verschoben wird. Verschiebungsereignisse werden weiterhin für die einzelnen Tabs innerhalb der Gruppe sowie für die Gruppe selbst ausgelöst. Dieses Ereignis wird nicht ausgelöst, wenn eine Gruppe zwischen Fenstern verschoben wird. Stattdessen wird sie aus einem Fenster entfernt und in einem anderen erstellt.

Parameter

  • callback

    Funktion

    Der Parameter callback sieht so aus: 

    (group: TabGroup) => void

onRemoved

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

Wird ausgelöst, wenn eine Gruppe geschlossen wird, entweder direkt durch den Nutzer oder automatisch, weil sie keine Tabs enthielt.

Parameter

  • callback

    Funktion

    Der Parameter callback sieht so aus: 

    (group: TabGroup) => void

onUpdated

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

Wird ausgelöst, wenn eine Gruppe aktualisiert wird.

Parameter

  • callback

    Funktion

    Der Parameter callback sieht so aus: 

    (group: TabGroup) => void