Dasmessage-Ereignis wird auf einemWorker-Objekt ausgelöst, wenn die übergeordnete Instanz des Workers eine Nachricht von ihrem Worker erhält (d.h. wenn der Worker eine Nachricht mithilfe vonDedicatedWorkerGlobalScope.postMessage() sendet).

Dieses Ereignis kann nicht abgebrochen werden und wird nicht weitergeleitet.

Syntax

Verwenden Sie den Ereignisnamen in Methoden wieaddEventListener() oder setzen Sie eine Ereignis-Handler-Eigenschaft.

addEventListener("message", (event) => { })onmessage = (event) => { }

Ereignistyp

EinMessageEvent. Erbt vonEvent.

Ereigniseigenschaften

Diese Schnittstelle erbt auch Eigenschaften von ihrem Elternteil,Event.

MessageEvent.dataSchreibgeschützt

Die vom Nachrichtenemittenten gesendeten Daten.

MessageEvent.originSchreibgeschützt

Ein String, der den Ursprung des Nachrichtenemittenten darstellt.

MessageEvent.lastEventIdSchreibgeschützt

Ein String, der eine eindeutige ID für das Ereignis darstellt.

MessageEvent.sourceSchreibgeschützt

EineMessageEventSource (die einWindowProxy,MessagePort oder einServiceWorker-Objekt sein kann), die den Nachrichtenemittenten darstellt.

MessageEvent.portsSchreibgeschützt

Ein Array vonMessagePort-Objekten, die die mit dem Kanal verbundenen Ports darstellen, über die die Nachricht gesendet wird (wo zutreffend, z. B. beim Kanal-Messaging oder beim Senden einer Nachricht an einen gemeinsamen Worker).

Beispiele

Dieser Code erstellt einen neuen Worker und hört Nachrichten von ihm mitaddEventListener() ab:

const worker = new Worker("static/scripts/worker.js");worker.addEventListener("message", (event) => {  console.log(`Received message from worker: ${event.data}`);});

Alternativ könnte er mit deronmessage-Ereignis-Handler-Eigenschaft abgehört werden:

const worker = new Worker("static/scripts/worker.js");worker.onmessage = (event) => {  console.log(`Received message from worker: ${event.data}`);};

Der Worker sendet Nachrichten mitself.postMessage():

// static/scripts/worker.jsself.postMessage("I'm alive!");

Spezifikationen

Browser-Kompatibilität

Siehe auch

• Verwandte Ereignisse:messageerror.
• DedicatedWorkerGlobalScope.postMessage().