tabs.ungroup()
Removes one or more tabs from their respective tab groups. A split view is removed from the group if either of its tabs is specified. If any groups become empty, they are deleted.
All tabs in a tab group must be adjacent. If necessary, an ungrouped tab is moved before or after the tab group to maintain this requirement.
Note:
The tabs.ungroup() method is not the only way to ungroup tabs. A tab is also ungrouped when it's moved by calling tabs.move with an index that is outside a tab group.
For more information on tab groups, see tabGroups.
Syntax
let ungrouping = browser.tabs.ungroup(
tabIds // array
)
Parameters
tabIds-
integerorarrayofinteger. The tab ID or list of tab IDs to remove from groups.
Return value
A Promise that is resolved with no arguments.
If any of the tabIds are invalid, the promise is rejected without modifying the tabs.
Examples
Remove the current tab from its tab group, if any:
let tabs = await browser.tabs.query({
active: true,
lastFocusedWindow: true,
});
await browser.tabs.ungroup([tabs[0].id]);
console.log("Current tab is ungrouped");
Browser compatibility
| desktop | mobile | ||||||
|---|---|---|---|---|---|---|---|
ungroup
|
|
|
|
|
|
|
|
Legend
Tip: you can click/tap on a cell for more information.
- Full support
- Full support
- No support
- No support