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

js
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. Gibt true zurück, wenn es zuhört, andernfalls false.

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

runtime.MessageSender.

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 einen onRequest-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.