CKTIS / HTML
onmessageerror — gestire gli errori di deserializzazione dei messaggi
L’attributo onmessageerror di body imposta il gestore messageerror dell’oggetto Window. L’evento segnala un errore nella deserializzazione di un messaggio in arrivo, non un errore di comunicazione generico.
Versione: WHATWG HTML Living Standard; index snapshot date recorded separately
Sintassi
<body onmessageerror="handler(event)">
window.onmessageerror = handler;
window.addEventListener("messageerror", handler);onmessageerror è un attributo HTML di gestione degli eventi per messageerror. Su body imposta un gestore per il Window associato, non per un evento diretto all’elemento stesso. Non è un attributo globale destinato a qualsiasi elemento. Il valore dell’attributo è codice JavaScript; il parametro event espone un MessageEvent.
Nelle comunicazioni tramite postMessage(), il destinatario ricostruisce i dati trasmessi usando la deserializzazione strutturata. Se questa fase non riesce, riceve messageerror invece di message. Non si tratta di una segnalazione generica di messaggi persi né di un errore nell’esecuzione del codice del destinatario. Un errore di serializzazione sul lato del mittente può invece generare un’eccezione sincrona DataCloneError durante la chiamata a postMessage().
In JavaScript, assegna una funzione a window.onmessageerror oppure usa window.addEventListener("messageerror", handler). L’attributo su body e la proprietà window.onmessageerror fanno riferimento allo stesso gestore; un’assegnazione successiva lo sostituisce e assegnare null lo rimuove. addEventListener() consente di aggiungere ascoltatori indipendenti.
L’esempio invia intenzionalmente un evento sintetico a window per ottenere un risultato deterministico. Verifica il collegamento dell’attributo al gestore di eventi, ma non causa un vero errore di deserializzazione. Una policy di sicurezza che blocca gli script o i gestori di eventi inline può impedirne l’esecuzione.
Esempi
<!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>Risultato
messageerror
Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.