Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

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.data

MessageEvent.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.

Źródła