CKTIS / JavaScript
MessageEvent.data — dati del messaggio
MessageEvent.data è una proprietà di sola lettura che espone i dati di un messaggio. Il tipo dipende dal meccanismo di messaggistica, quindi non dare per scontato che il valore sia sempre testo.
Versione: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintassi
event.dataMessageEvent.data espone i dati forniti dal mittente di un messaggio. Puoi leggerli da un’istanza dell’evento tramite event.data, non direttamente dal costruttore MessageEvent.
Il valore può avere tipi diversi a seconda del meccanismo che ha creato l’evento. Prima di usarlo, verifica il tipo e la struttura previsti; il nome data da solo non implica che si tratti di testo o di un formato particolare.
La proprietà è di sola lettura: non serve a sostituire i dati dell’evento assegnando un valore a event.data. Quando crei un evento con new MessageEvent("message", { data: value }), fornisci i dati nelle opzioni del costruttore. Se ometti l’opzione data, il valore è null.
Questa è una Web API, non una funzionalità legata a una specifica edizione di ECMAScript. MDN segnala un’ampia disponibilità della proprietà da luglio 2015 e del costruttore usato nell’esempio da agosto 2016. L’esempio crea un evento localmente, senza inviare un messaggio.
Esempi
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);Risultato
hello 3 true
Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.