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
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
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()
chrome.tabGroups.get(
groupId: number,
callback?: function,
)
Ruft Details zur angegebenen Gruppe ab.
Parameter
-
groupId
Zahl
-
callback
Funktion optional
Der Parameter
callback
sieht so aus:(group: TabGroup) => void
-
Gruppe
-
Rückgabe
-
Promise<TabGroup>
Chrome 90 oder höherPromise-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()
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.
Parameter
-
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ückgabe
-
Promise<TabGroup | undefined>
Chrome 90 oder höherPromise-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()
chrome.tabGroups.query(
queryInfo: object,
callback?: function,
)
Ruft alle Gruppen mit den angegebenen Eigenschaften ab oder alle Gruppen, wenn keine Eigenschaften angegeben wurden.
Parameter
-
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
-
Ergebnis
TabGroup[]
-
Rückgabe
-
Promise<TabGroup[]>
Chrome 90 oder höherPromise-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()
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.
Parameter
-
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ückgabe
-
Promise<TabGroup | undefined>
Chrome 90 oder höherPromise-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
Parameter
-
callback
Funktion
Der Parameter
callback
sieht so aus:(group: TabGroup) => void
-
Gruppe
-
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.
Parameter
-
callback
Funktion
Der Parameter
callback
sieht so aus:(group: TabGroup) => void
-
Gruppe
-
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
Parameter
-
callback
Funktion
Der Parameter
callback
sieht so aus:(group: TabGroup) => void
-
Gruppe
-
onUpdated
chrome.tabGroups.onUpdated.addListener(
callback: function,
)
Wird ausgelöst, wenn eine Gruppe aktualisiert wird