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 並附帶錯誤訊息。

瀏覽器相容性