MessageEvent: MessageEvent() Konstruktor

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.

Hinweis: Dieses Feature ist verfügbar in Web Workers.

Der MessageEvent() Konstruktor erstellt ein neues MessageEvent Objekt.

Syntax

js
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

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

Spezifikationen

Specification
HTML Standard
# the-messageevent-interface:dom-event-constructor

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch

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