Fired when the extension is first installed, when the extension is updated to a new version, and when the browser is updated to a new version.
Note that
runtime.onInstalled
is not the same as
management.onInstalled
。
runtime.onInstalled
event is fired only for your extension. The
browser.management.onInstalled
event is fired for any extensions.
browser.runtime.onInstalled.addListener(listener)
浏览器
.
runtime
.
onInstalled
.
removeListener
(
listener
)
浏览器
.
runtime
.
onInstalled
.
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)
Checks whether a
listener
is registered for this event. Returns
true
if it is listening,
false
否则。
function
The callback function called when this event occurs. The function will be passed the following arguments:
details
An object with the following properties:
id
可选
string
. The ID of the imported shared module extension that updated. This is present only if the
reason
value is
shared_module_update
.
previousVersion
可选
string
. The previous version of the extension just updated. This is only present if the
reason
value is
update
.
reason
An
runtime.OnInstalledReason
value, stating the reason that this event is being dispatched.
temporary
boolean
. True if the add-on was installed temporarily. For example, using the "about:debugging" page in Firefox or using
web-ext run
. False otherwise.
BCD tables only load in the browser
When the extension is installed, log the install reason and open https://example.com :
function handleInstalled(details) {
console.log(details.reason);
browser.tabs.create({
url: "https://example.com"
});
}
browser.runtime.onInstalled.addListener(handleInstalled);
注意：
This API is based on Chromium's
chrome.runtime
API. This documentation is derived from
runtime.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.
最后修改： , 由 MDN 贡献者