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

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 lauscht, andernfalls false.

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

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 undefiniert, wenn es keine Antwort gibt. 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 aus extension.json im Chromium-Code abgeleitet.