CKTIS / JavaScript
MessageEvent.data — données du message
MessageEvent.data est une propriété en lecture seule qui expose les données utiles d’un message. Son type dépend du mécanisme de messagerie ; ne supposez donc pas que sa valeur est toujours du texte.
Version : ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntaxe
event.dataMessageEvent.data expose les données fournies par l’expéditeur d’un message. Vous les lisez depuis une instance d’événement avec event.data, et non directement depuis le constructeur MessageEvent.
La valeur peut avoir différents types selon le mécanisme qui a créé l’événement. Vérifiez le type et la structure attendus avant de l’utiliser ; le nom data ne signifie pas, à lui seul, qu’il s’agit de texte ou d’un format particulier.
Cette propriété est en lecture seule : elle ne permet pas de remplacer les données de l’événement en affectant une valeur à event.data. Lors de la création d’un événement avec new MessageEvent("message", { data: value }), fournissez les données dans les options du constructeur. Si l’option data est omise, la valeur est null.
Il s’agit d’une API Web, et non d’une fonctionnalité liée à une édition particulière d’ECMAScript. MDN indique une large disponibilité de la propriété depuis juillet 2015 et du constructeur utilisé dans l’exemple depuis août 2016. L’exemple crée un événement localement sans envoyer de message.
Exemples
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);Résultat
hello 3 true
Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.