CKTIS / JavaScript
MessageEvent.data — berichtgegevens
MessageEvent.data is een alleen-lezen eigenschap die de gegevens van een bericht beschikbaar maakt. Het type hangt af van het gebruikte berichtenmechanisme; ga er dus niet van uit dat de waarde altijd tekst is.
Versie: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntax
event.dataMessageEvent.data maakt de gegevens beschikbaar die door de afzender van een bericht zijn aangeleverd. Je leest ze uit een gebeurtenisinstantie met event.data, niet rechtstreeks uit de MessageEvent-constructor.
De waarde kan verschillende typen hebben, afhankelijk van het mechanisme waarmee de gebeurtenis is gemaakt. Controleer vóór gebruik het verwachte type en de structuur; de naam data betekent op zichzelf niet dat het om tekst of een bepaald formaat gaat.
De eigenschap is alleen-lezen: je kunt de gegevens van de gebeurtenis niet vervangen door een waarde toe te wijzen aan event.data. Geef de gegevens bij het maken van een gebeurtenis met new MessageEvent("message", { data: value }) mee via de constructoropties. Als je de optie data weglaat, is de waarde null.
Dit is een Web API, geen functie die bij een bepaalde ECMAScript-editie hoort. MDN vermeldt dat de eigenschap sinds juli 2015 breed beschikbaar is en de constructor uit het voorbeeld sinds augustus 2016. Het voorbeeld maakt lokaal een gebeurtenis aan zonder een bericht te verzenden.
Voorbeelden
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);Resultaat
hello 3 true
De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.