tabGroups.query()
Gibt alle Tab-Gruppen zurück oder sucht nach Gruppen mit bestimmten Eigenschaften.
Syntax
js
let group = await browser.tabGroups.query(
queryInfo // object
);
Parameter
queryInfo-
Ein Objekt mit Angaben zu den Eigenschaftswerten, die die zurückgegebenen Tab-Gruppen erfüllen müssen.
collapsedOptional-
boolean. Gibt an, ob die zurückgegebenen Tab-Gruppen in der Tableiste eingeklappt oder ausgeklappt sind.- In Firefox kann eine eingeklappte Gruppe den aktiven Tab enthalten. Der aktive Tab bleibt sichtbar, während inaktive Tabs eingeklappt werden.
- In Chrome werden Gruppen vollständig eingeklappt. Wenn die Gruppe beim Einklappen den aktiven Tab enthält, wird dieser zum ersten Tab rechts neben der Gruppe verschoben. Gibt es rechts neben der Gruppe keinen Tab, wird er zum unmittelbar links neben der Gruppe befindlichen Tab verschoben.
colorOptional-
tabGroups.Color. Der Name der Farbe, die die zurückgegebenen Tab-Gruppen verwenden. -
boolean. Gibt an, ob die zurückgegebenen Tab-Gruppen geteilt sind. titleOptional-
string. Der Name der zurückzugebenden Tab-Gruppen. windowIdOptional-
integer. Die ID des Fensters, in dem sich die zurückgegebenen Tab-Gruppen befinden.
Rückgabewert
Ein Promise, das mit einem Array von tabGroups.TabGroup-Objekten erfüllt wird. Schlägt die Anfrage fehl, wird das Promise mit einer Fehlermeldung zurückgewiesen.