tabGroups.query

Return all tab groups or find groups with certain properties.

Syntax

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

Parameters

queryInfo

An object containing details of the property values to be matched in returned tab groups.

collapsed Optional

boolean. Whether the returned tab groups are collapsed or expanded in the tab strip.

color Optional

tabGroups.Color. The name of the color returned tab groups are using.

shared Optional

boolean. Whether the returned tab groups are shared.

title Optional

string. The name of the tab groups to return.

windowId Optional

integer. The ID of the window the returned tab group are in.

Return value

A Promise fulfilled with an array of tabGroups.TabGroup objects. If the request fails, the promise is rejected with an error message.

Browser compatibility