runtime.onInstalled

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.

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.

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);

• runtime-examples