CKTIS / JavaScript
MessageEvent: source, origin en data
Onderscheid de verwijzing naar de afzender, diens origin bij verzending en de gegevens die je controleert voordat je een vensterbericht verwerkt.
Versie: ECMAScript 2024 and the current web platform; runtime support varies
Syntax
event.source
event.origin
event.datasource, origin en data zijn alleen-lezen eigenschappen van een MessageEvent-instantie. Ze horen bij een API van het webplatform, niet bij ECMAScript 2024; de beschikbaarheid hangt af van de uitvoeringsomgeving.
Bij Window.postMessage() is event.source de WindowProxy van de browsercontext van de afzender. Als een venster zichzelf een bericht stuurt, hebben de afzender en de ontvanger dezelfde WindowProxy. Afhankelijk van de API kan source ook een MessagePort zijn (bijvoorbeeld bij de gebeurtenis connect van een gedeelde worker), een ServiceWorker of null. Bij een gewone message-gebeurtenis via een MessagePort is source gelijk aan null en origin aan "".
Bij berichten tussen vensters bevat event.origin de geserialiseerde origin van de afzender op het moment van verzenden: schema, host en eventueel poort, zonder pad, query of fragment. Na navigatie kan dezelfde WindowProxy naar een ander document verwijzen. origin zegt dus niet wat er nu is geladen. Een opake origin wordt geserialiseerd als de tekenreeks "null", niet als de lege tekenreeks "" of de JavaScript-waarde null.
event.data bevat de verzonden gegevens. Window.postMessage() gebruikt het algoritme voor gestructureerd klonen, geen JSON of directe verwijzing naar het oorspronkelijke object. Als je een niet-kloonbare waarde zoals een functie verzendt, krijgt de verzender een DataCloneError.
Vergelijk voordat je data gebruikt de origin met de exacte verwachte origin via ===, controleer source als je weet welk venster je verwacht, en valideer de structuur en waarden van de gegevens. Geef bij verzenden of antwoorden een exacte targetOrigin op als die bekend is. Die beperkt de ontvanger, maar vervangt diens controles bij ontvangst niet. Verstuur geen vertrouwelijke gegevens met "*".
Voorbeelden
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<title>MessageEvent: source, origin, and data</title>
</head>
<body>
<script>
(() => {
const expectedOrigin = window.location.origin;
const expectedSource = window;
function receive(event) {
if (event.origin !== expectedOrigin || event.source !== expectedSource) return;
const data = event.data;
if (data === null || typeof data !== "object" ||
data.type !== "cktis:count" || !Number.isInteger(data.count)) return;
window.removeEventListener("message", receive);
console.log(`source === window: ${event.source === window}`);
console.log(`origin === expectedOrigin: ${event.origin === expectedOrigin}`);
console.log(`data.count: ${data.count}`);
}
window.addEventListener("message", receive);
window.postMessage({ type: "cktis:count", count: 7 }, expectedOrigin);
})();
</script>
</body>
</html>Resultaat
source === window: true origin === expectedOrigin: true data.count: 7
Bied het HTML-bestand aan via HTTP(S) en open het in een browsertabblad zonder sandbox. Het venster stuurt zichzelf een bericht. De drie regels verschijnen asynchroon in de browserconsole nadat de handler het bericht heeft geaccepteerd en zijn listener heeft verwijderd.
Gerelateerde lessen
- JavaScript · Les 5 · Gevorderd · Versie: 4