runtime.onStartup
Fired when a profile that has this extension installed first starts up. This event is not fired when a private browsing/incognito profile is started, even if this extension is operating in 'split' incognito mode.
Syntax
browser.runtime.onStartup.addListener(listener)
browser.runtime.onStartup.removeListener(listener)
browser.runtime.onStartup.hasListener(listener)
Event Functions
All events have three functions:
addListener(listener)
-
Adds a
listener
to the calling event. removeListener(listener)
-
Stop listening to the calling event. The
listener
argument is the listener to remove. hasListener(listener)
-
Checks whether a
listener
is registered for the calling event. Returnstrue
if it is listening,false
otherwise.
Parameters
The only parameter is listener
, used for any of the above functions.
listener
-
A function that will be called when this event occurs.
Browser compatibility
BCD tables only load in the browser
Examples
Open https://giphy.com/explore/cat when the browser starts up:
function handleStartup() {
browser.tabs.create({
url: "https://giphy.com/explore/cat"
});
}
browser.runtime.onStartup.addListener(handleStartup);
Note: This API is based on Chromium's chrome.runtime
API. This documentation is derived from runtime.json
in the Chromium code.