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");

浏览器兼容性