CKTIS / JavaScript
MessageEvent.data — údaje správy
MessageEvent.data je vlastnosť iba na čítanie, ktorá sprístupňuje údaje správy. Ich typ závisí od použitého mechanizmu posielania správ, preto nepredpokladajte, že hodnota je vždy text.
Verzia: 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 sprístupňuje údaje odovzdané odosielateľom správy. Čítate ich z inštancie udalosti pomocou event.data, nie priamo z konštruktora MessageEvent.
Hodnota môže mať rôzne typy podľa mechanizmu, ktorý udalosť vytvoril. Pred použitím skontrolujte očakávaný typ a štruktúru; samotný názov data neznamená, že ide o text alebo konkrétny formát.
Vlastnosť je iba na čítanie: neslúži na nahradenie údajov udalosti priradením hodnoty do event.data. Pri vytváraní udalosti pomocou new MessageEvent("message", { data: value }) odovzdajte údaje v možnostiach konštruktora. Ak možnosť data vynecháte, výsledná hodnota je null.
Ide o Web API, nie o funkciu viazanú na konkrétne vydanie ECMAScriptu. MDN uvádza širokú dostupnosť vlastnosti od júla 2015 a konštruktora použitého v príklade od augusta 2016. Príklad vytvára udalosť lokálne bez odoslania správy.
Príklady
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);Výsledok
hello 3 true
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.