runtime.onInstalled

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)

Hört auf, dieses Ereignis zu überwachen. Das Argument listener ist der Listener, der entfernt werden soll.

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 eintritt. Der Funktion werden folgende 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 ausgelöst wird.

temporary

boolean. Wahr, wenn das Add-on vorübergehend installiert wurde. Zum Beispiel durch die Seite "about:debugging" in Firefox oder unter Verwendung von web-ext run. Falsch andernfalls.

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

Beispielerweiterungen

• runtime-examples
• userScripts-mv3

Browser-Kompatibilität