tabs.ungroup()

將一個或多個標籤頁從其所屬的標籤頁組中移除。如果某個組變為空,則該組會被刪除。

標籤頁組內的所有標籤頁必須是連續的。如果需要,未分組的標籤頁會被移動到標籤頁組之前或之後,以滿足此要求。

注意:tabs.ungroup() 方法並非取消標籤頁分組的唯一方式。當透過呼叫 tabs.move 並將 index 設定為標籤頁組之外的值來移動標籤頁時,該標籤頁也會被取消分組。

有關標籤頁組的更多資訊,請參閱 tabGroups

語法

js
let ungrouping = browser.tabs.ungroup(
  tabIds              // array
)

引數

tabIds

integerintegerarray。要從組中移除的標籤頁 ID 或標籤頁 ID 列表。

返回值

一個 Promise,它在不帶引數的情況下解析。

如果任何 tabIds 無效,則 Promise 會被拒絕,並且不會修改任何標籤頁。

示例

將當前標籤頁從其標籤頁組中移除(如果存在)。

js
let tabs = await browser.tabs.query({
  active: true,
  lastFocusedWindow: true,
});

await browser.tabs.ungroup([tabs[0].id]);
console.log("Current tab is ungrouped");

瀏覽器相容性