CKTIS / JavaScript
MessageEvent.data — dane wiadomości
MessageEvent.data to właściwość tylko do odczytu, która udostępnia dane wiadomości. Ich typ zależy od mechanizmu wysyłania, więc nie należy zakładać, że zawsze jest to tekst.
Wersja: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Składnia
event.dataMessageEvent.data udostępnia dane przekazane przez nadawcę wiadomości. Odczytujesz je z instancji zdarzenia przez event.data, a nie bezpośrednio z konstruktora MessageEvent.
Wartość może mieć różne typy, zależnie od mechanizmu, który utworzył zdarzenie. Przed użyciem danych sprawdź oczekiwany typ i strukturę; sama nazwa data nie oznacza tekstu ani określonego formatu.
Właściwość jest tylko do odczytu: nie służy do zastępowania danych zdarzenia przez przypisanie do event.data. Podczas tworzenia zdarzenia przez new MessageEvent("message", { data: value }) dane przekazujesz w opcjach konstruktora. Pominięcie opcji data daje null.
To Web API, a nie funkcja przypisana do konkretnej edycji ECMAScript. MDN wskazuje szeroką dostępność właściwości od lipca 2015 r. oraz konstruktora użytego w przykładzie od sierpnia 2016 r. Przykład tworzy zdarzenie lokalnie, bez wysyłania wiadomości.
Przykłady
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);Wynik
hello 3 true
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.