KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

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

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

Bronnen