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 findet Gruppen mit bestimmten Eigenschaften.

Syntax

js
let group = await browser.tabGroups.query(
    queryInfo                // object
);

Parameter

queryInfo

Ein Objekt, das Details zu den Eigenschaftswerten enthält, die in den zurückgegebenen Tab-Gruppen übereinstimmen sollen.

collapsed Optional

boolean. Ob die zurückgegebenen Tab-Gruppen in der Tableiste zusammengeklappt oder erweitert sind.

  • In Firefox kann eine zusammengeklappte Gruppe den aktiven Tab enthalten. Der aktive Tab bleibt sichtbar und inaktive Tabs sind zusammengeklappt.
  • In Chrome sind Gruppen vollständig zusammengeklappt. Wenn die Gruppe den aktiven Tab enthält, wenn sie zusammengeklappt ist, wird der aktive Tab auf den ersten Tab rechts von der Gruppe verschoben. Wenn es keinen Tab rechts von der Gruppe gibt, wird er auf den Tab direkt links von der Gruppe verschoben.
color Optional

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

shared Optional

boolean. Ob die zurückgegebenen Tab-Gruppen gemeinsam genutzt werden.

title Optional

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

windowId Optional

integer. Die ID des Fensters, in dem sich die zurückgegebene Tab-Gruppe befindet.

Rückgabewert

Ein Promise, das mit einem Array von tabGroups.TabGroup-Objekten erfüllt wird. Wenn die Anfrage fehlschlägt, wird das Versprechen mit einer Fehlermeldung abgelehnt.

Browser-Kompatibilität