CKTIS / JavaScript
MessageEvent.data — данни на съобщението
MessageEvent.data е свойство само за четене, което предоставя данните на съобщението. Типът им зависи от механизма за обмен на съобщения, затова не приемайте, че стойността винаги е текст.
Версия: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Синтаксис
event.dataMessageEvent.data предоставя данните, подадени от изпращача на съобщението. Четете ги от екземпляр на събитието чрез event.data, а не директно от конструктора MessageEvent.
Стойността може да бъде от различни типове в зависимост от механизма, създал събитието. Преди да я използвате, проверете очаквания тип и структура; самото име data не означава, че става дума за текст или за конкретен формат.
Свойството е само за четене: то не служи за замяна на данните на събитието чрез присвояване на стойност на event.data. Когато създавате събитие с new MessageEvent("message", { data: value }), подайте данните в опциите на конструктора. Ако пропуснете опцията data, стойността е null.
Това е Web API, а не функция, обвързана с конкретно издание на ECMAScript. MDN посочва широка наличност на свойството от юли 2015 г. и на конструктора, използван в примера, от август 2016 г. Примерът създава събитие локално, без да изпраща съобщение.
Примери
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);Резултат
hello 3 true
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.