Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / JavaScript

MessageEvent.data — datos del mensaje

MessageEvent.data es una propiedad de solo lectura que expone los datos de un mensaje. Su tipo depende del mecanismo de mensajería, así que no des por hecho que el valor siempre es texto.

Versión: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Sintaxis

event.data

MessageEvent.data expone los datos proporcionados por quien envía el mensaje. Se leen desde una instancia del evento mediante event.data, no directamente desde el constructor MessageEvent.

El valor puede tener distintos tipos según el mecanismo que haya creado el evento. Comprueba el tipo y la estructura esperados antes de usarlo; el nombre data por sí solo no implica que sea texto ni que tenga un formato concreto.

La propiedad es de solo lectura: no sirve para sustituir los datos del evento asignando un valor a event.data. Al crear un evento con new MessageEvent("message", { data: value }), proporciona los datos en las opciones del constructor. Si se omite la opción data, el valor es null.

Se trata de una API web, no de una función vinculada a una edición concreta de ECMAScript. MDN indica que la propiedad está ampliamente disponible desde julio de 2015 y que el constructor usado en el ejemplo lo está desde agosto de 2016. El ejemplo crea un evento localmente, sin enviar ningún mensaje.

Ejemplos

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

El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.

Fuentes