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

CKTIS / HTML

onmessageerror — обработване на грешка при десериализация на съобщение

Атрибутът onmessageerror на body задава обработчика messageerror на обекта Window. Събитието сигнализира за неуспешна десериализация на получено съобщение, а не за произволна комуникационна грешка.

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

Синтаксис

<body onmessageerror="handler(event)">
window.onmessageerror = handler;
window.addEventListener("messageerror", handler);

onmessageerror е HTML атрибут за обработчик на събитието messageerror. На body той задава обработчик за свързания Window, а не за събитие, насочено към самия елемент. Това не е глобален атрибут за произволни елементи. Стойността на атрибута е JavaScript код; параметърът event предоставя достъп до MessageEvent.

При комуникация чрез postMessage() получателят възстановява предадените данни чрез структурирана десериализация. Ако тази стъпка не успее, той получава messageerror вместо message. Това не е общо известие за изгубени съобщения, нито грешка при изпълнение на кода на получателя. Грешка при сериализация от страна на изпращача може вместо това да доведе до синхронно изключение DataCloneError при извикване на postMessage().

В JavaScript задайте функция на window.onmessageerror или използвайте window.addEventListener("messageerror", handler). Атрибутът на body и свойството window.onmessageerror се отнасят до един и същ обработчик; следващо присвояване го заменя, а присвояването на null го премахва. addEventListener() позволява добавяне на независими слушатели.

Примерът умишлено изпраща синтетично събитие към window, за да осигури детерминиран резултат. Той проверява свързването на атрибута с обработчика на събития, но не предизвиква действителна грешка при десериализация. Политика за сигурност, която блокира вградени скриптове или обработчици на събития, може да попречи на изпълнението му.

Примери

<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>onmessageerror demo</title>
<body onmessageerror="document.getElementById('result').textContent = event.type">
<pre id="result">waiting</pre>
<script>
  window.dispatchEvent(new MessageEvent('messageerror'));
</script>
</body>
</html>

Резултат

messageerror

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

Източници