CKTIS / HTML
onmessage — obrada poruka prozora
Atribut onmessage elementa body postavlja rukovatelj događajem message objekta Window. Prima, između ostaloga, poruke poslane putem postMessage; prije uporabe primljenih podataka provjerite pošiljatelja i sadržaj.
Verzija: WHATWG HTML Living Standard; index snapshot date recorded separately
Sintaksa
<body onmessage="handleMessage(event)">
window.onmessage = handleMessage;
window.addEventListener("message", handleMessage);onmessage je atribut rukovatelja događajem message. U HTML-u se može nalaziti na elementu body; nije globalni atribut. Njegov kôd obrađuje događaje objekta Window, a ne poruke upućene samom elementu body. Vrijednost atributa je JavaScript kôd koji ima pristup parametru event.
U JavaScriptu window.onmessage = handleMessage postavlja isti rukovatelj. Sljedeća ga dodjela zamjenjuje, a dodjela vrijednosti null uklanja ga. window.addEventListener("message", handleMessage) omogućuje registriranje dodatnih slušatelja bez zamjene tog rukovatelja.
Poruka poslana putem postMessage isporučuje se asinkrono kao MessageEvent: event.data sadrži podatke, event.origin određuje podrijetlo pošiljatelja, a event.source identificira izvor. Provjerite očekivano podrijetlo i izvor te strukturu podataka. Pri slanju navedite točno ciljno podrijetlo umjesto "*", osobito za povjerljive podatke. Sam atribut ne šalje poruke.
Primjer šalje poruku istom prozoru. Pokrenite ga putem lokalnog HTTP-a, a ne kao dokument file:. Očekivani je rezultat da se Waiting promijeni u Hello. CSP koja blokira ugrađeni kôd može spriječiti izvršavanje skripte ili atributa; u tom okruženju premjestite kôd u dopuštenu JavaScript datoteku i upotrijebite addEventListener.
Primjeri
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<title>Body onmessage handler</title>
</head>
<body onmessage="if (event.source === window && event.origin === window.origin && event.data === 'Hello') document.getElementById('result').textContent = event.data;">
<p id="result" aria-live="polite">Waiting</p>
<script>
// The destination is this same window, and the payload is not sensitive.
// A wildcard also works when the document has an opaque origin.
window.postMessage('Hello', '*');
</script>
</body>
</html>Rezultat
Hello
Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.