tabs.getSelected()
This method has been deprecated. Use tabs.query({active: true})
instead.
Gets the tab that is selected in the specified window.
This is an asynchronous function that returns a Promise
.
Syntax
var gettingSelected = browser.tabs.getSelected(
windowId // optional integer
)
Parameters
Return value
A Promise
that will be fulfilled with a tabs.Tab
object containing information about the selected tab. If the tab could not be found or some other error occurs, the promise will be rejected with an error message.
Browser compatibility
Report problems with this compatibility data on GitHubwebextensions-desktop | webextensions-mobile | |||||
---|---|---|---|---|---|---|
getSelected | ChromeFull supportYes | EdgeFull support79 | FirefoxNo supportNo | OperaNo supportNo | SafariFull support14 | Firefox for AndroidNo supportNo |
Legend
- Full support
- Full support
- No support
- No support
- Non-standard. Check cross-browser support before using.
- Deprecated. Not for use in new websites.
The compatibility table on this page is generated from structured data. If you'd like to contribute to the data, please check out https://github.com/mdn/browser-compat-data and send us a pull request.
Acknowledgements
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.