tabs.onCreated
Fired when a tab is created.
Fired when a tab is created.
Note that the tab's URL may not be given its final value at the time this event fired. In particular, Firefox opens a new tab with the URL "about:blank" before loading the new page into it. You can listen to tabs.onUpdated events to be notified when a URL is set.
Syntax
browser.tabs.onCreated.addListener(listener)
browser.tabs.onCreated.removeListener(listener)
browser.tabs.onCreated.hasListener(listener)
Events have three functions:
addListener(listener)- : Adds a listener to this event.
removeListener(listener)- : Stop listening to this event. The
listenerargument is the listener to remove. hasListener(listener)- : Check whether
listeneris registered for this event. Returnstrueif it is listening,falseotherwise.
addListener syntax
Parameters
listener- : The function called when this event occurs. The function is passed this argument:
tab- : tabs.Tab. Details of the tab that was created.
Examples
Log the IDs of newly created tabs:
function handleCreated(tab) {
console.log(tab.id);
}
browser.tabs.onCreated.addListener(handleCreated);
Browser compatibility
[!NOTE] This API is based on Chromium's
chrome.tabsAPI. This documentation is derived fromtabs.jsonin the Chromium code.