CKTIS / HTML
onmessage — obravnava sporočil okna
Atribut onmessage elementa body nastavi obravnavo dogodka message objekta Window. Med drugim prejema sporočila, poslana z metodo postMessage; pred uporabo prejetih podatkov preverite pošiljatelja in vsebino.
Različica: WHATWG HTML Living Standard; index snapshot date recorded separately
Sintaksa
<body onmessage="handleMessage(event)">
window.onmessage = handleMessage;
window.addEventListener("message", handleMessage);onmessage je atribut za obravnavo dogodka message. V HTML je lahko na elementu body; ni globalni atribut. Njegova koda obravnava dogodke objekta Window, ne pa sporočil, naslovljenih neposredno na element body. Vrednost atributa je koda JavaScript, ki ima dostop do parametra event.
V JavaScriptu window.onmessage = handleMessage nastavi isto obravnavo. Naslednja dodelitev jo zamenja, dodelitev null pa jo odstrani. Z window.addEventListener("message", handleMessage) lahko registrirate dodatne poslušalnike, ne da bi zamenjali to obravnavo.
Sporočilo, poslano z metodo postMessage, je asinhrono dostavljeno kot MessageEvent: event.data vsebuje podatke, event.origin določa izvor pošiljatelja, event.source pa identificira vir. Preverite pričakovani izvor in vir ter strukturo podatkov. Pri pošiljanju navedite natančen ciljni izvor namesto "*", zlasti pri zaupnih podatkih. Atribut sam ne pošilja sporočil.
Primer pošlje sporočilo istemu oknu. Zaženite ga prek lokalnega HTTP, ne kot dokument file:. Pričakovani rezultat je sprememba Waiting v Hello. CSP, ki blokira vdelano kodo, lahko prepreči izvajanje skripta ali atributa; v takem okolju premaknite kodo v dovoljeno datoteko JavaScript in uporabite addEventListener.
Primeri
<!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
Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.