База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / HTML

onmessage — обработване на съобщения на прозореца

Атрибутът onmessage на body задава обработчика за събитието message на обекта Window. Той получава, наред с други, съобщения, изпратени чрез postMessage; проверявайте подателя и данните, преди да ги използвате.

Версия: WHATWG HTML Living Standard; index snapshot date recorded separately

Синтаксис

<body onmessage="handleMessage(event)">
window.onmessage = handleMessage;
window.addEventListener("message", handleMessage);

onmessage е атрибут за обработчик на събитието message. В HTML може да бъде зададен на елемента body; той не е глобален атрибут. Кодът му обработва събития на обекта Window, а не съобщения, адресирани до самия елемент body. Стойността на атрибута е JavaScript код с достъп до параметъра event.

В JavaScript window.onmessage = handleMessage задава същия обработчик. Следващо присвояване го заменя, а присвояването на null го премахва. window.addEventListener("message", handleMessage) позволява да се регистрират допълнителни слушатели, без този обработчик да бъде заменен.

Съобщение, изпратено чрез postMessage, се доставя асинхронно като MessageEvent: event.data съдържа данните, event.origin посочва произхода на подателя, а event.source идентифицира източника. Проверявайте очакваните произход и източник, както и структурата на данните. При изпращане задавайте точния целеви произход вместо "*", особено за поверителни данни. Самият атрибут не изпраща съобщения.

Примерът изпраща съобщение до същия прозорец. Стартирайте го през локален HTTP, а не като документ file:. Очакваният резултат е Waiting да се промени на Hello. CSP, която блокира вградения код, може да попречи на изпълнението на скрипта или атрибута; в такава среда преместете кода в разрешен JavaScript файл и използвайте addEventListener.

Примери

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

Резултат

Hello

Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.

Източници