CKTIS / HTML
onmessage — zpracování zpráv okna
Atribut onmessage prvku body nastavuje obsluhu události message objektu Window. Přijímá mimo jiné zprávy odeslané pomocí postMessage; před použitím přijatých dat ověřte odesílatele a obsah zprávy.
Verze: WHATWG HTML Living Standard; index snapshot date recorded separately
Syntaxe
<body onmessage="handleMessage(event)">
window.onmessage = handleMessage;
window.addEventListener("message", handleMessage);onmessage je atribut obsluhy události message. V HTML může být uveden na prvku body; nejde o globální atribut. Jeho kód zpracovává události objektu Window, nikoli zprávy adresované samotnému prvku body. Hodnota atributu je kód JavaScriptu s přístupem k parametru event.
V JavaScriptu nastaví window.onmessage = handleMessage stejnou obsluhu. Další přiřazení ji nahradí a přiřazení null ji odstraní. Pomocí window.addEventListener("message", handleMessage) lze registrovat další posluchače, aniž by se tato obsluha nahradila.
Zpráva odeslaná pomocí postMessage je asynchronně doručena jako MessageEvent: event.data obsahuje data, event.origin určuje původ odesílatele a event.source identifikuje zdroj. Ověřte očekávaný původ a zdroj i strukturu dat. Při odesílání uveďte přesný cílový původ namísto "*", zejména u důvěrných dat. Samotný atribut zprávy neodesílá.
Příklad odesílá zprávu do stejného okna. Spusťte jej přes místní HTTP, nikoli jako dokument file:. Očekávaným výsledkem je změna Waiting na Hello. CSP, která blokuje vložený kód, může zabránit spuštění skriptu nebo atributu; v takovém prostředí přesuňte kód do povoleného souboru JavaScriptu a použijte addEventListener.
Pří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ýsledek
Hello
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.