extension.onRequest
Warnung: Dies ist nicht in Firefox implementiert, da es seit Chrome 33 veraltet ist. Bitte verwenden Sie stattdessen runtime.onMessage.
Wird ausgelöst, wenn eine Anfrage entweder von einem Erweiterungsprozess oder einem Inhaltsskript gesendet wird.
Syntax
chrome.extension.onRequest.addListener(function(
request, // optional any
sender, // runtime.MessageSender
() => {/* … */} // function
) {/* … */})
chrome.extension.onRequest.removeListener(listener)
chrome.extension.onRequest.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
listener
für dieses Ereignis registriert ist. Gibttrue
zurück, wenn es lauscht, andernfallsfalse
.
addListener-Syntax
Parameter
listener
-
Die Funktion, die aufgerufen wird, wenn dieses Ereignis eintritt. Der Funktion werden diese Argumente übergeben:
request
-
any
. Die Anfrage, die vom aufrufenden Skript gesendet wird. sender
sendResponse
-
function
. Funktion, die (höchstens einmal) aufgerufen wird, wenn Sie eine Antwort haben. Das Argument sollte ein beliebiges JSON-fähiges Objekt sein oder undefiniert, wenn es keine Antwort gibt. Wenn Sie mehr als einenonRequest
-Listener im selben Dokument haben, darf nur einer eine Antwort senden.
Browser-Kompatibilität
Hinweis:
Diese API basiert auf der chrome.extension
API von Chromium. Diese Dokumentation ist aus extension.json
im Chromium-Code abgeleitet.