CKTIS / JavaScript
window.postMessage — berichten tussen vensters
window.postMessage verstuurt asynchroon gegevens naar een doelvenster, ook tussen verschillende origins. Geef bij voorkeur een exacte `targetOrigin` op. Laat je die weg, dan blijft bezorging beperkt tot dezelfde origin. Ontvangers moeten de origin van de afzender, het verzendende venster en de gegevensstructuur controleren.
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
targetWindow.postMessage(message, targetOrigin[, transfer])
targetWindow.postMessage(message[, { targetOrigin, transfer }])window.postMessage is een browser-API die is gedefinieerd door de HTML Living Standard, geen functie uit een bepaalde ECMAScript-editie. Huidige browser-engines ondersteunen deze API; de aanwezigheid van Node 24 in een repository bewijst niet dat de API daar beschikbaar is. Roep de methode aan op het ontvangende venster, zoals iframe.contentWindow of een verwijzing naar een geopend venster. Berichten versturen geeft geen toegang tot het DOM van een andere origin.
De ontvanger krijgt asynchroon een message-gebeurtenis: event.data bevat de gegevens, event.origin bevat de geserialiseerde origin van de afzender op het moment van versturen en event.source verwijst naar het verzendende venster. Bij een origin in de vorm van een tuple bepalen het schema, de host en de poort de origin, niet het pad. Een opake origin heeft geen dergelijke tuple en wordt geserialiseerd als de tekenreeks "null". Met een controle op alleen die tekenreeks kun je opake origins niet van elkaar onderscheiden. Registreer de listener voordat je iets verstuurt; stem bij een nieuw frame af wanneer de ontvanger klaar is.
Geef een exacte targetOrigin op. Als die niet overeenkomt met de origin van de ontvanger, wordt het bericht genegeerd. In de vorm met een optiesobject is de standaardwaarde voor een weggelaten targetOrigin "/", zodat bezorging beperkt blijft tot dezelfde origin. Met "*" is elke origin toegestaan — gebruik dit niet voor vertrouwelijke gegevens. Ontvangers moeten event.origin, event.source en de gegevensstructuur controleren; behandel berichten nooit als code.
Gegevens worden geserialiseerd met het structured-clone-algoritme, niet als JSON. Functies kunnen niet worden gekloond. De lijst transfer verplaatst bronnen in plaats van ze te kopiëren: een overgedragen ArrayBuffer wordt aan de verzendende kant losgekoppeld. Niet-kloonbare gegevens of dubbele items in de transferlijst kunnen een DataCloneError veroorzaken. In het voorbeeld stuurt een iframe in een sandbox via window.parent.postMessage een bericht naar het bovenliggende venster. Dat venster controleert of event.origin gelijk is aan "null" en event.source naar het venster van het iframe verwijst. Daarna controleert het de gegevens en schrijft het received: 42 naar de console.
Voorbeelden
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<title>Send a message from an iframe</title>
</head>
<body>
<script>
const frame = document.createElement('iframe');
frame.title = 'Message sender';
frame.hidden = true;
frame.setAttribute('sandbox', 'allow-scripts');
// Use the page's exact origin when it has an HTTP(S) origin.
// The wildcard fallback carries only the fixed, non-sensitive fixture.
const targetOrigin = /^https?:\/\//.test(window.origin) ? window.origin : '*';
function receive(event) {
// The sandboxed sender has an opaque origin, serialized as "null".
if (event.origin !== 'null' || event.source !== frame.contentWindow) return;
const data = event.data;
if (data === null || typeof data !== 'object' || Array.isArray(data)) return;
if (data.type !== 'cktis-demo' || data.value !== 42) return;
window.removeEventListener('message', receive);
console.log(`received: ${data.value}`);
}
window.addEventListener('message', receive);
frame.srcdoc = `<!doctype html>
<html lang="en">
<head><meta charset="utf-8"><title>Message sender</title></head>
<body>
<script>
window.parent.postMessage({ type: 'cktis-demo', value: 42 }, ${JSON.stringify(targetOrigin)});
<\/script>
</body>
</html>`;
document.body.append(frame);
</script>
</body>
</html>Resultaat
received: 42
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.