chrome.tabGroups

Beschreibung

Mit der chrome.tabGroups API können Sie mit dem Tab-Gruppensystem des Browsers interagieren. Mit dieser API können Sie Tabgruppen im Browser ändern und neu anordnen. Mit der chrome.tabs API können Sie Tabs gruppieren und die Gruppierung aufheben oder abfragen, welche Tabs in Gruppen enthalten sind.

Berechtigungen

tabGroups

Verfügbarkeit

Chrome 89 und höher MV3 und höher

Typen

Color

Die Farbe der Gruppe.

Enum

"grey"

"blue"

"rot"

"yellow"

„grün“

"pink"

"purple"

"cyan"

"orange"

TabGroup

Attribute

  • Minimiert

    boolean

    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

    Ausstehend

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

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

Ruft Details zur angegebenen Gruppe ab.

Parameter

  • groupId

    Zahl

  • callback

    function optional

    Der Parameter callback sieht so aus: 

    (group: TabGroup) => void

Ausgabe

  • Promise<TabGroup>

    Chrome 90 und höher

    Versprechen werden in Manifest V3 und höher unterstützt, aber Callbacks sind für die Abwärtskompatibilität verfügbar. Sie können nicht beide für denselben Funktionsaufruf verwenden. Das Versprechen wird mit demselben Typ aufgelöst, der an den Rückruf übergeben wird.

move()

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

Die Gruppe und alle zugehörigen Tabs werden innerhalb des Fensters oder in ein neues Fenster verschoben.

Parameter

  • groupId

    Zahl

    Die ID der Gruppe, die verschoben werden soll.

  • 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 ist das Fenster ausgewählt, in dem sich die Gruppe gerade befindet. Gruppen können nur zwischen Fenstern mit dem windows.WindowType-Typ "normal" verschoben werden.

  • callback

    function optional

    Der Parameter callback sieht so aus: 

    (group?: TabGroup) => void

    • Gruppe

      TabGroup optional

      Details zur verschobenen Gruppe.

Ausgabe

  • Promise<TabGroup | undefined>

    Chrome 90 und höher

    Versprechen werden in Manifest V3 und höher unterstützt, aber Callbacks sind für die Abwärtskompatibilität verfügbar. Sie können nicht beide für denselben Funktionsaufruf verwenden. Das Versprechen wird mit demselben Typ aufgelöst, der an den Rückruf übergeben wird.

query()

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

Hiermit werden alle Gruppen mit den angegebenen Eigenschaften oder alle Gruppen abgerufen, wenn keine Eigenschaften angegeben sind.

Parameter

  • queryInfo

    Objekt

    • Minimiert

      boolescher Wert optional

      Ob die Gruppen minimiert sind.

    • Farbe

      Farbe optional

      Die Farbe der Gruppen.

    • geteilt

      boolescher Wert optional

      Ausstehend

      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.

  • callback

    function optional

    Der Parameter callback sieht so aus: 

    (result: TabGroup[]) => void

Ausgabe

  • Promise<TabGroup[]>

    Chrome 90 und höher

    Versprechen werden in Manifest V3 und höher unterstützt, aber Callbacks sind für die Abwärtskompatibilität verfügbar. Sie können nicht beide für denselben Funktionsaufruf verwenden. Das Versprechen wird mit demselben Typ aufgelöst, der an den Rückruf übergeben wird.

update()

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

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

Parameter

  • groupId

    Zahl

    Die ID der Gruppe, die geändert werden soll.

  • updateProperties

    Objekt

    • Minimiert

      boolescher Wert optional

      Gibt an, ob die Gruppe minimiert werden soll.

    • Farbe

      Farbe optional

      Die Farbe der Gruppe.

    • Titel

      String optional

      Der Titel der Gruppe.

  • callback

    function optional

    Der Parameter callback sieht so aus: 

    (group?: TabGroup) => void

    • Gruppe

      TabGroup optional

      Details zur aktualisierten Gruppe.

Ausgabe

  • Promise<TabGroup | undefined>

    Chrome 90 und höher

    Versprechen werden in Manifest V3 und höher unterstützt, aber Callbacks sind für die Abwärtskompatibilität verfügbar. Sie können nicht beide für denselben Funktionsaufruf verwenden. Das Versprechen wird mit demselben Typ aufgelöst, der an den Rückruf übergeben wird.

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

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

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

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