Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

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

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.

Zdroje