Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

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 &amp;&amp; event.origin === window.origin &amp;&amp; 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.

Viri