tabs.onActivated
Fires when the active tab in a window changes. Note that the tab's URL may not be set at the time this event fired, but you can listen to tabs.onUpdated
events to be notified when a URL is set.
Syntax
browser.tabs.onActivated.addListener(listener)
browser.tabs.onActivated.removeListener(listener)
browser.tabs.onActivated.hasListener(listener)
Events have three functions:
addListener(callback)
- Adds a listener to this event.
removeListener(listener)
- Stop listening to this event. The
listener
argument is the listener to remove. hasListener(listener)
- Check whether
listener
is registered for this event. Returnstrue
if it is listening,false
otherwise.
addListener syntax
Parameters
callback
-
Function that will be called when this event occurs. The function will be passed the following arguments:
activeInfo
object
. ID of the tab that was made active, and ID of its window.
Additional objects
activeInfo
previousTabId
integer
. The ID of the previous activated tab, if that tab is still open.tabId
integer
. The ID of the tab that has become active.windowId
integer
. The ID of the tab's window.
Examples
Listen for and log tab activation events:
function handleActivated(activeInfo) {
console.log("Tab " + activeInfo.tabId +
" was activated");
}
browser.tabs.onActivated.addListener(handleActivated);
Example extensions
Browser compatibility
Report problems with this compatibility data on GitHubwebextensions-desktop | webextensions-mobile | |||||
---|---|---|---|---|---|---|
onActivated | ChromeFull supportYes | EdgeFull support14 | FirefoxFull support45 | OperaFull supportYes | SafariFull support14 | Firefox for AndroidFull support54 |
Legend
- Full support
- Full support
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.