runtime.onInstalled
Wird ausgelöst, wenn die Erweiterung erstmals installiert wird, wenn die Erweiterung auf eine neue Version aktualisiert wird und wenn der Browser auf eine neue Version aktualisiert wird.
Beachten Sie, dass runtime.onInstalled
nicht dasselbe ist wie management.onInstalled
. Das runtime.onInstalled
-Ereignis wird nur für Ihre Erweiterung ausgelöst. Das browser.management.onInstalled
-Ereignis wird für jede Erweiterung ausgelöst.
Syntax
browser.runtime.onInstalled.addListener(listener)
browser.runtime.onInstalled.removeListener(listener)
browser.runtime.onInstalled.hasListener(listener)
Ereignisse haben drei Funktionen:
addListener(listener)
-
Fügt diesem Ereignis einen Listener hinzu.
removeListener(listener)
-
Stoppt das Lauschen auf dieses Ereignis. Das Argument
listener
ist der zu entfernende Listener. hasListener(listener)
-
Überprüft, ob ein
listener
für dieses Ereignis registriert ist. Gibttrue
zurück, wenn gelauscht wird, andernfallsfalse
.
addListener-Syntax
Parameter
function
-
Die Funktion, die aufgerufen wird, wenn dieses Ereignis eintritt. Der Funktion werden folgende Argumente übergeben:
details
-
Ein Objekt mit den folgenden Eigenschaften:
id
Optional-
string
. Die ID der importierten, aktualisierten, gemeinsam genutzten Module-Erweiterung. Dies ist nur vorhanden, wenn derreason
-Wertshared_module_update
ist. previousVersion
Optional-
string
. Die vorherige Version der soeben aktualisierten Erweiterung. Dies ist nur vorhanden, wenn derreason
-Wertupdate
ist. reason
-
Ein
runtime.OnInstalledReason
-Wert, der den Grund angibt, warum dieses Ereignis ausgelöst wird. temporary
-
boolean
. Wahr, wenn das Add-on vorübergehend installiert wurde. Zum Beispiel durch Verwendung der "about:debugging"-Seite in Firefox oder durch Verwendung von web-ext run. Andernfalls falsch.
Browser-Kompatibilität
BCD tables only load in the browser
Beispiele
Wenn die Erweiterung installiert wird, protokollieren Sie den Installationsgrund und öffnen Sie https://example.com:
function handleInstalled(details) {
console.log(details.reason);
browser.tabs.create({
url: "https://example.com",
});
}
browser.runtime.onInstalled.addListener(handleInstalled);
Beispiel-Erweiterungen
Hinweis: Diese API basiert auf der chrome.runtime
-API von Chromium. Diese Dokumentation ist abgeleitet von runtime.json
im Chromium-Code.