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

js
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. Gibt true zurück, wenn gelauscht wird, andernfalls false.

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 der reason-Wert shared_module_update ist.

previousVersion Optional

string. Die vorherige Version der soeben aktualisierten Erweiterung. Dies ist nur vorhanden, wenn der reason-Wert update 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:

js
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.