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

Syntax von addListener

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 gemeinsamen Modulerweiterung, 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 vorübergehend installiert wurde. Zum Beispiel mit der "about:debugging"-Seite in Firefox oder mit web-ext run. Andernfalls false.

Browser-Kompatibilität

Beispiele

Wenn die Erweiterung installiert wird, protokollieren Sie den Installationsgrund und öffnen https://example.com:

function handleInstalled(details) {
  console.log(details.reason);
  browser.tabs.create({
    url: "https://example.com",
  });
}

browser.runtime.onInstalled.addListener(handleInstalled);

Beispielerweiterungen

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