chrome.tabGroups

Beschreibung

Verwenden Sie die chrome.tabGroups API, um mit dem Tabgruppierungssystem des Browsers zu interagieren. Sie können diese API verwenden, um Tabgruppen im Browser zu ändern und neu anzuordnen. Verwenden Sie die chrome.tabs API, um Tabs zu gruppieren bzw. ihre Gruppierung aufzuheben oder abzufragen, welche Tabs in Gruppen enthalten sind.

Berechtigungen

tabGroups

Verfügbarkeit

Chrome 89 oder höher MV3+

Typen

Color

Die Farbe der Gruppe.

Enum

"grey"

"pink"

TabGroup

Attribute

  • minimiert

    boolean

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

  • Farbe

    Farbe

    Die Farbe der Gruppe.

  • id

    Zahl

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

  • Titel

    String optional

    Der Titel der Gruppe.

  • windowId

    Zahl

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

Attribute

TAB_GROUP_ID_NONE

ID, die das Fehlen einer Gruppe angibt.

Wert

-1

Methoden

get()

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

Ruft Details zur angegebenen Gruppe ab.

Parameters

  • groupId

    Zahl

  • callback

    Funktion optional

    Der Parameter callback sieht so aus: 

    (group: TabGroup)=>void

Rückgaben

  • Promise<TabGroup>

    Chrome 90 oder höher

    Promise-Objekte werden in Manifest V3 und höher unterstützt, Callbacks werden jedoch aus Gründen der Abwärtskompatibilität bereitgestellt. Sie können nicht beide in einem Funktionsaufruf verwenden. Das Promise wird mit demselben Typ aufgelöst, der an den Callback übergeben wird.

move()

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

Verschiebt die Gruppe und alle zugehörigen Tabs innerhalb ihres Fensters oder in ein neues Fenster.

Parameters

  • groupId

    Zahl

    Die ID der zu verschiebenden Gruppe.

  • moveProperties

    Objekt

    • Index

      Zahl

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

    • windowId

      Nummer optional

      Das Fenster, in das die Gruppe verschoben werden soll. Die Standardeinstellung ist das Fenster, in dem sich die Gruppe derzeit befindet. Gruppen können nur zu und aus Fenstern mit dem windows.WindowType-Typ "normal" verschoben werden.

  • callback

    Funktion optional

    Der Parameter callback sieht so aus: 

    (group?: TabGroup)=>void

    • Gruppe

      TabGroup optional

      Details zur verschobenen Gruppe

Rückgaben

  • Promise<TabGroup|nicht definiert>

    Chrome 90 oder höher

    Promise-Objekte werden in Manifest V3 und höher unterstützt, Callbacks werden jedoch aus Gründen der Abwärtskompatibilität bereitgestellt. Sie können nicht beide in einem Funktionsaufruf verwenden. Das Promise wird mit demselben Typ aufgelöst, der an den Callback übergeben wird.

query()

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

Ruft alle Gruppen mit den angegebenen Eigenschaften ab oder alle Gruppen, wenn keine Eigenschaften angegeben wurden.

Parameters

  • queryInfo

    Objekt

    • minimiert

      Boolescher Wert optional

      Gibt an, ob die Gruppen minimiert werden.

    • Farbe

      Farbe optional

      Die Farbe der Gruppen.

    • Titel

      String optional

      Gleichen Sie Gruppentitel mit einem Muster ab.

    • windowId

      Nummer optional

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

  • callback

    Funktion optional

    Der Parameter callback sieht so aus: 

    (result: TabGroup[])=>void

Rückgaben

  • Promise<TabGroup[]>

    Chrome 90 oder höher

    Promise-Objekte werden in Manifest V3 und höher unterstützt, Callbacks werden jedoch aus Gründen der Abwärtskompatibilität bereitgestellt. Sie können nicht beide in einem Funktionsaufruf verwenden. Das Promise wird mit demselben Typ aufgelöst, der an den Callback übergeben wird.

update()

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

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

Parameters

  • groupId

    Zahl

    Die ID der zu ändernden Gruppe.

  • updateProperties

    Objekt

    • minimiert

      Boolescher Wert optional

      Legt fest, ob die Gruppe minimiert werden soll.

    • Farbe

      Farbe optional

      Die Farbe der Gruppe.

    • Titel

      String optional

      Der Titel der Gruppe.

  • callback

    Funktion optional

    Der Parameter callback sieht so aus: 

    (group?: TabGroup)=>void

    • Gruppe

      TabGroup optional

      Details zur aktualisierten Gruppe.

Rückgaben

  • Promise<TabGroup|nicht definiert>

    Chrome 90 oder höher

    Promise-Objekte werden in Manifest V3 und höher unterstützt, Callbacks werden jedoch aus Gründen der Abwärtskompatibilität bereitgestellt. Sie können nicht beide in einem Funktionsaufruf verwenden. Das Promise wird mit demselben Typ aufgelöst, der an den Callback übergeben wird.

Veranstaltungen

onCreated

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

Wird ausgelöst, wenn eine Gruppe erstellt wird

Parameters

  • 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 Verschiebeereignisse 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 von einem Fenster zu einem anderen verschoben wird. Stattdessen wird sie aus einem Fenster entfernt und in einem anderen erstellt.

Parameters

  • 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 durch den Nutzer oder automatisch, weil sie keine Tabs enthielt

Parameters

  • 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

Parameters

  • callback

    Funktion

    Der Parameter callback sieht so aus: 

    (group: TabGroup)=>void