Hinweis: Diese Funktion ist in Web Workers verfügbar.

Der MessageEvent() Konstruktor erstellt ein neues MessageEvent Objekt.

Syntax

new MessageEvent(type)
new MessageEvent(type, options)

Parameter

type

Ein String mit dem Namen des Events. Er ist case-sensitive und Browser setzen ihn immer auf message.

options Optional

Ein Objekt, das zusätzlich zu den in Event() definierten Eigenschaften die folgenden Eigenschaften haben kann:

data Optional

Die Daten, die im MessageEvent enthalten sein sollen. Dies kann ein beliebiger Datentyp sein und wird standardmäßig auf null gesetzt, wenn nicht angegeben.

origin Optional

Ein String, der den Ursprung des Nachrichtensenders darstellt. Standardmäßig wird ein leerer String ('') verwendet, wenn nichts angegeben ist.

lastEventId Optional

Ein String, der eine eindeutige ID für das Event darstellt. Standardmäßig wird ein leerer String ("") verwendet, wenn nichts angegeben ist.

source Optional

Eine MessageEventSource (die ein Window, ein MessagePort oder ein ServiceWorker Objekt sein kann), die den Nachrichtensender darstellt. Diese wird standardmäßig auf null gesetzt, wenn sie nicht festgelegt ist.

ports Optional

Ein Array von MessagePort Objekten, das alle MessagePort Objekte enthält, die mit der Nachricht in der Reihenfolge gesendet wurden. Dies wird standardmäßig auf ein leeres Array ([]) gesetzt, wenn nichts angegeben ist.

Rückgabewert

Ein neues MessageEvent Objekt.

Beispiele

const myMessage = new MessageEvent("message", {
  data: "hello",
});

Spezifikationen

Browser-Kompatibilität

Siehe auch

• ExtendableMessageEvent — ähnlich dieser Schnittstelle, aber in Schnittstellen verwendet, die Autoren mehr Flexibilität bieten müssen.