Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

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

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

Fontes