CKTIS / JavaScript
MessageEvent.data — dados da mensagem
MessageEvent.data é uma propriedade só de leitura que expõe os dados de uma mensagem. O tipo depende do mecanismo de mensagens, por isso não assuma que o valor é sempre texto.
Versão: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintaxe
event.dataMessageEvent.data expõe os dados fornecidos pelo emissor de uma mensagem. Pode lê-los a partir de uma instância do evento através de event.data, e não diretamente do construtor MessageEvent.
O valor pode ter tipos diferentes, consoante o mecanismo que criou o evento. Antes de o utilizar, confirme o tipo e a estrutura esperados; o nome data, por si só, não significa que seja texto nem que tenha um formato específico.
A propriedade é só de leitura: não serve para substituir os dados do evento através de uma atribuição a event.data. Ao criar um evento com new MessageEvent("message", { data: value }), forneça os dados nas opções do construtor. Se omitir a opção data, o valor é null.
Esta é uma API Web, não uma funcionalidade associada a uma edição específica do ECMAScript. A MDN indica ampla disponibilidade da propriedade desde julho de 2015 e do construtor utilizado no exemplo desde agosto de 2016. O exemplo cria um evento localmente, sem enviar uma mensagem.
Exemplos
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);Resultado
hello 3 true
O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.