Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

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

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

Fonti