Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

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

Zdroje