CKTIS / JavaScript
MessageEvent.data — Nachrichtendaten
MessageEvent.data ist eine schreibgeschützte Eigenschaft, die die Nutzdaten einer Nachricht bereitstellt. Ihr Typ hängt vom verwendeten Nachrichtenmechanismus ab; gehe daher nicht davon aus, dass der Wert immer Text ist.
Version: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntax
event.dataMessageEvent.data stellt die Daten bereit, die ein Nachrichtensender übermittelt hat. Du liest sie über event.data aus einer Ereignisinstanz aus, nicht direkt über den MessageEvent-Konstruktor.
Der Wert kann je nach Mechanismus, durch den das Ereignis erstellt wurde, unterschiedliche Typen haben. Prüfe vor der Verwendung den erwarteten Typ und die Struktur; der Name data allein bedeutet weder, dass es sich um Text handelt, noch dass ein bestimmtes Format vorliegt.
Die Eigenschaft ist schreibgeschützt: Sie ist nicht dafür gedacht, die Ereignisdaten durch eine Zuweisung an event.data zu ersetzen. Beim Erstellen eines Ereignisses mit new MessageEvent("message", { data: value }) übergibst du die Daten in den Konstruktoroptionen. Wird die Option data weggelassen, ist der Wert null.
Dies ist eine Web-API und keine Funktion einer bestimmten ECMAScript-Ausgabe. MDN gibt an, dass die Eigenschaft seit Juli 2015 und der im Beispiel verwendete Konstruktor seit August 2016 breit verfügbar sind. Das Beispiel erstellt lokal ein Ereignis, ohne eine Nachricht zu senden.
Beispiele
const event = new MessageEvent("message", {
data: { text: "hello", count: 3 }
});
console.log(event.data.text);
console.log(event.data.count);
console.log(new MessageEvent("message").data === null);Ergebnis
hello 3 true
Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.