webNavigation.onTabReplaced
Fired when the contents of the tab is replaced by a different (usually previously pre-rendered) tab.
Syntax
js
browser.webNavigation.onTabReplaced.addListener(
listener, // function
filter // optional object
);
browser.webNavigation.onTabReplaced.removeListener(listener)
browser.webNavigation.onTabReplaced.hasListener(listener)
Events have three functions:
addListener(listener)
-
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
Additional objects
details
replacedTabId
-
integer
. The ID of the tab that was replaced. tabId
-
integer
. The ID of the tab that replaced the old tab. timeStamp
-
number
. The time when the replacement happened, in milliseconds since the epoch.
Browser compatibility
BCD tables only load in the browser
Examples
js
function logOnTabReplaced(details) {
console.log(`onTabReplaced ${details}`);
}
browser.webNavigation.onTabReplaced.addListener(logOnTabReplaced);
Note:
This API is based on Chromium's chrome.webNavigation
API. This documentation is derived from web_navigation.json
in the Chromium code.