tabGroups.query

返回所有标签组或查找具有特定属性的组。

语法

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

参数

queryInfo

一个包含要在返回的标签组中匹配的属性值的详细信息的对象。

collapsed 可选

boolean。返回的标签组在标签栏中是折叠还是展开。

  • 在 Firefox 中,折叠的组可以包含活动标签。活动标签保持可见,而不活动的标签则被折叠。
  • 在 Chrome 中,组会被完全折叠。如果组包含活动标签并且该组被折叠,活动标签将被移动到组右侧的第一个标签。如果组右侧没有标签,它将被移动到组左侧的第一个标签。
color 可选

tabGroups.Color。返回的标签组使用的颜色的名称。

shared 可选

boolean。返回的标签组是否共享。

title 可选

string。要返回的标签组的名称。

windowId 可选

integer。返回的标签组所在的窗口的 ID。

返回值

一个 Promise,它会 fulfilled 为一个 tabGroups.TabGroup 对象数组。如果请求失败,Promise 将被 rejection 并附带错误消息。

浏览器兼容性