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 && event.origin === window.origin && 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
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.