Dieser Inhalt wurde automatisch aus dem Englischen übersetzt, und kann Fehler enthalten. Erfahre mehr über dieses Experiment.

View in English Always switch to English

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.

collapsed Optional

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.
color Optional

tabGroups.Color. Der Name der Farbe, die die zurückgegebenen Tab-Gruppen verwenden.

shared Optional

boolean. Gibt an, ob die zurückgegebenen Tab-Gruppen geteilt sind.

title Optional

string. Der Name der zurückzugebenden Tab-Gruppen.

windowId Optional

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.

Browser-Kompatibilität