chrome.tabGroups

Beschreibung

Mit der chrome.tabGroups API können Sie mit dem Tabgruppierungssystem des Browsers interagieren. Mit dieser API können Sie Tabgruppen im Browser ändern und neu anordnen. Wenn Sie Tabs gruppieren oder 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+ MV3+

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. Eine minimierte Gruppe ist eine Gruppe, deren Tabs ausgeblendet sind.

  • Farbe

    Farbe

    Die Farbe der Gruppe.

  • id

    Zahl

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

  • geteilt

    boolean

    Chrome 137+

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

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

Ruft Details zur angegebenen Gruppe ab.

Parameter

  • groupId

    Zahl

Ausgabe

  • Promise<TabGroup>

    Chrome 90 und höher

move()

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

Verschiebt die Gruppe und alle zugehörigen 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 Typ windows.WindowType "normal" verschoben werden.

Ausgabe

  • Promise<TabGroup | undefined>

    Chrome 90 und höher

query()

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

      boolean optional

      Ob die Gruppen minimiert sind.

    • Farbe

      Farbe optional

      Die Farbe der Gruppen.

    • geteilt

      boolean optional

      Chrome 137+

      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

update()

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

Ändert die Attribute 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

      boolean 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

Ereignisse

onCreated

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

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

Wird ausgelöst, wenn eine Gruppe in einem Fenster verschoben wird. Verschiebungsereignisse werden weiterhin für die einzelnen Tabs in 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

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

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

Parameter

  • callback

    Funktion

    Der Parameter callback sieht so aus: 

    (group: TabGroup) => void

onUpdated

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