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 alle Erweiterungen 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 Zuhören für dieses Ereignis. Das listener-Argument ist der zu entfernende Listener.
hasListener(listener): Überprüft, ob ein listener für dieses Ereignis registriert ist. Gibt true zurück, wenn es zuhört, andernfalls false.

addListener-Syntax

Parameter

function

Die Funktion, die aufgerufen wird, wenn dieses Ereignis auftritt. Der Funktion werden diese Argumente übergeben:

details

Ein Objekt mit den folgenden Eigenschaften:

id Optional: string. Die ID der importierten Shared Module-Erweiterung, die aktualisiert wurde. Dies ist nur vorhanden, wenn der reason-Wert shared_module_update ist.
previousVersion Optional: string. Die vorherige Version der gerade aktualisierten Erweiterung. Dies ist nur vorhanden, wenn der reason-Wert update ist.
reason: Ein runtime.OnInstalledReason-Wert, der den Grund angibt, warum dieses Ereignis gesendet wird.
temporary: boolean. Wahr, wenn das Add-on zeitweilig installiert wurde. Zum Beispiel mit der Seite „about:debugging“ in Firefox oder mit web-ext run. Andernfalls falsch.

Beispiele

Wenn die Erweiterung installiert wird, loggen 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);

Beispielerweiterungen

Browser-Kompatibilität

Hinweis: Diese API basiert auf der chrome.runtime-API von Chromium. Diese Dokumentation ist abgeleitet von runtime.json im Chromium-Code.