Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

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

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

Zdroje