extension.onRequest
Warnung: Dies ist in Firefox nicht implementiert, da es seit Chrome 33 veraltet ist. Bitte nutzen 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 zuhört, andernfallsfalse
.
addListener-Syntax
Parameter
listener
-
Die aufgerufene Funktion, wenn dieses Ereignis eintritt. Der Funktion werden folgende Argumente übergeben:
request
-
any
. Die vom aufrufenden Skript gesendete Anfrage. 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 undefined, wenn keine Antwort erforderlich ist. 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 abgeleitet von extension.json
im Chromium-Code.