CKTIS / JavaScript
MessageEvent.data — data zprávy
MessageEvent.data je vlastnost pouze pro čtení, která zpřístupňuje data zprávy. Jejich typ závisí na použitém mechanismu předávání zpráv, proto nepředpokládejte, že hodnota je vždy text.
Verze: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntaxe
event.dataMessageEvent.data zpřístupňuje data předaná odesílatelem zprávy. Čtete je z instance události pomocí event.data, nikoli přímo z konstruktoru MessageEvent.
Hodnota může mít různé typy podle mechanismu, který událost vytvořil. Před použitím ověřte očekávaný typ a strukturu; samotný název data neznamená, že jde o text nebo konkrétní formát.
Vlastnost je pouze pro čtení: neslouží k nahrazení dat události přiřazením hodnoty do event.data. Při vytváření události pomocí new MessageEvent("message", { data: value }) předejte data v možnostech konstruktoru. Pokud možnost data vynecháte, výsledná hodnota je null.
Jde o Web API, nikoli o funkci vázanou na konkrétní vydání ECMAScriptu. MDN uvádí širokou dostupnost vlastnosti od července 2015 a konstruktoru použitého v příkladu od srpna 2016. Příklad vytváří událost lokálně a neodesílá žádnou zprávu.
Pří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ýsledek
hello 3 true
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.