Closes one or more tabs.
This is an asynchronous function that returns a Promise
.
var removing = browser.tabs.remove( tabIds // integer or integer array )
tabIds
integer
or array
of integer
The ids of the tab or tabs to close.A Promise
that will be fulfilled with no arguments when all the specified tabs have been removed or their beforeunload
prompts have been handled. If any error occurs, the promise will be rejected with an error message.
Close a single tab:
function onRemoved() { console.log(`Removed`); } function onError(error) { console.log(`Error: ${error}`); } var removing = browser.tabs.remove(2); removing.then(onRemoved, onError);
Close multiple tabs:
function onRemoved() { console.log(`Removed`); } function onError(error) { console.log(`Error: ${error}`); } var removing = browser.tabs.remove([15, 14, 1]); removing.then(onRemoved, onError);
Desktop | Mobile | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
Chrome | Edge | Firefox | Internet Explorer | Opera | Safari | WebView Android | Chrome Android | Firefox for Android | Opera Android | Safari on IOS | Samsung Internet | |
remove |
Yes |
14 |
45 |
? |
Yes |
14 |
? |
? |
54 |
? |
? |
? |
Note: This API is based on Chromium's chrome.tabs
API. This documentation is derived from tabs.json
in the Chromium code.
Microsoft Edge compatibility data is supplied by Microsoft Corporation and is included here under the Creative Commons Attribution 3.0 United States License.
© 2005–2021 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Mozilla/Add-ons/WebExtensions/API/tabs/remove