runtime.onUserScriptConnect

Wird ausgelöst, wenn eine Verbindung mit einem Benutzerskript aus einer der USER_SCRIPT-Welten der Erweiterung hergestellt wird. Weitere Informationen finden Sie in den USER_SCRIPT worlds.

In Firefox erfordert dieses Ereignis die userScripts-Berechtigung. In Chrome ist das Ereignis immer vorhanden, auch in Erweiterungen, die die userScripts-Berechtigung nicht deklarieren.

Ein Benutzerskript kann nur aus einer USER_SCRIPT-Welt, die durch userScripts.configureWorld() mit messaging auf true konfiguriert ist, eine Verbindung herstellen und Nachrichten senden.

Syntax

js
browser.runtime.onUserScriptConnect.addListener(listener)
browser.runtime.onUserScriptConnect.removeListener(listener)
browser.runtime.onUserScriptConnect.hasListener(listener)

Ereignisse haben drei Funktionen:

addListener(listener)

Fügt diesem Ereignis einen Listener hinzu.

removeListener(listener)

Beendet das Abhören dieses Ereignisses. Das Argument listener ist der zu entfernende Listener.

hasListener(listener)

Prüft, ob ein listener für dieses Ereignis registriert ist. Gibt true zurück, wenn es aktiv ist, andernfalls false.

addListener-Syntax

Parameter

function

Die Funktion, die aufgerufen wird, wenn dieses Ereignis eintritt. Der Funktion wird folgendes Argument übergeben:

port

runtime.Port. Ein Objekt, das das aktuelle Skript mit dem anderen Kontext verbindet.

Browser-Kompatibilität