Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

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 &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

Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.

Izvori