CKTIS / HTML
onmessage — spracovanie správ okna
Atribút onmessage prvku body nastavuje obsluhu udalosti message objektu Window. Prijíma okrem iného správy odoslané cez postMessage; pred použitím prijatých údajov overte odosielateľa a obsah správy.
Verzia: WHATWG HTML Living Standard; index snapshot date recorded separately
Syntax
<body onmessage="handleMessage(event)">
window.onmessage = handleMessage;
window.addEventListener("message", handleMessage);onmessage je atribút obsluhy udalosti message. V HTML môže byť uvedený na prvku body; nejde o globálny atribút. Jeho kód spracúva udalosti objektu Window, nie správy adresované samotnému prvku body. Hodnota atribútu je kód JavaScriptu s prístupom k parametru event.
V JavaScripte nastaví window.onmessage = handleMessage tú istú obsluhu. Ďalšie priradenie ju nahradí a priradenie null ju odstráni. Pomocou window.addEventListener("message", handleMessage) možno registrovať ďalších poslucháčov bez nahradenia tejto obsluhy.
Správa odoslaná cez postMessage sa doručí asynchrónne ako MessageEvent: event.data obsahuje údaje, event.origin určuje pôvod odosielateľa a event.source identifikuje zdroj. Overte očakávaný pôvod a zdroj aj štruktúru údajov. Pri odosielaní uveďte presný cieľový pôvod namiesto "*", najmä pri dôverných údajoch. Samotný atribút správy neodosiela.
Príklad odosiela správu do toho istého okna. Spustite ho cez miestne HTTP, nie ako dokument file:. Očakávaným výsledkom je zmena Waiting na Hello. CSP, ktorá blokuje vložený kód, môže zabrániť vykonaniu skriptu alebo atribútu; v takom prostredí presuňte kód do povoleného súboru JavaScriptu a použite addEventListener.
Príklady
<!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>Výsledok
Hello
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.