CKTIS / HTML
onmessageerror — obsługa błędu deserializacji wiadomości
Atrybut onmessageerror elementu body ustawia procedurę obsługi zdarzenia messageerror obiektu Window. Zdarzenie sygnalizuje nieudaną deserializację otrzymanej wiadomości, a nie dowolny błąd komunikacji.
Wersja: WHATWG HTML Living Standard; index snapshot date recorded separately
Składnia
<body onmessageerror="handler(event)">
window.onmessageerror = handler;
window.addEventListener("messageerror", handler);onmessageerror jest atrybutem HTML obsługi zdarzenia messageerror. Na elemencie body ustawia procedurę obsługi dla powiązanego obiektu Window, a nie zdarzenia skierowanego do samego elementu. Nie jest atrybutem globalnym przeznaczonym dla dowolnego elementu. Wartością atrybutu jest kod JavaScript; parametr event udostępnia zdarzenie typu MessageEvent.
Przy komunikacji przez postMessage() odbiorca odtwarza przesłane dane za pomocą deserializacji strukturalnej. Jeśli ten etap zawiedzie, otrzymuje messageerror zamiast message. To nie jest ogólny sygnał utraty wiadomości ani błąd wykonania kodu odbiorcy. Błąd serializacji po stronie nadawcy może natomiast spowodować synchroniczny wyjątek DataCloneError podczas wywołania postMessage().
W JavaScript można przypisać funkcję do window.onmessageerror albo użyć window.addEventListener("messageerror", handler). Atrybut na body i właściwość window.onmessageerror odnoszą się do tej samej procedury obsługi; kolejne przypisanie ją zastępuje, a przypisanie null ją usuwa. addEventListener() pozwala dodawać niezależnych słuchaczy.
Przykład celowo wysyła syntetyczne zdarzenie do window, aby wynik był deterministyczny. Sprawdza powiązanie atrybutu z obsługą zdarzenia, ale nie wywołuje rzeczywistego błędu deserializacji. Polityka bezpieczeństwa blokująca skrypty lub procedury obsługi zapisane bezpośrednio w HTML może uniemożliwić jego wykonanie.
Przykłady
<!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>Wynik
messageerror
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.