CKTIS / HTML
onmessageerror — gestionar errores de deserialización de mensajes
El atributo onmessageerror de body establece el controlador messageerror del objeto Window. El evento indica que no se ha podido deserializar un mensaje recibido, no un error de comunicación cualquiera.
Versión: WHATWG HTML Living Standard; index snapshot date recorded separately
Sintaxis
<body onmessageerror="handler(event)">
window.onmessageerror = handler;
window.addEventListener("messageerror", handler);onmessageerror es un atributo HTML de controlador de eventos para messageerror. En body, establece un controlador para el Window asociado, no para un evento dirigido al propio elemento. No es un atributo global para cualquier elemento. El valor del atributo es código JavaScript; el parámetro event proporciona un MessageEvent.
En la comunicación mediante postMessage(), el receptor reconstruye los datos transmitidos mediante deserialización estructurada. Si ese paso falla, recibe messageerror en lugar de message. No es un aviso general de pérdida de mensajes ni un error al ejecutar el código del receptor. En cambio, un fallo de serialización en el emisor puede lanzar una excepción síncrona DataCloneError al llamar a postMessage().
En JavaScript, asigna una función a window.onmessageerror o usa window.addEventListener("messageerror", handler). El atributo de body y la propiedad window.onmessageerror hacen referencia al mismo controlador; una asignación posterior lo sustituye y asignarle null lo elimina. addEventListener() permite añadir escuchadores independientes.
El ejemplo activa deliberadamente un evento sintético en window para obtener un resultado determinista. Comprueba la conexión del atributo con el controlador de eventos, pero no provoca un fallo real de deserialización. Una política de seguridad que bloquee los scripts o los controladores de eventos en línea puede impedir que se ejecute.
Ejemplos
<!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>Resultado
messageerror
El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.