CKTIS / HTML
onmessageerror — fouten bij berichtdeserialisatie afhandelen
Het attribuut onmessageerror op body stelt de messageerror-handler van het Window-object in. De gebeurtenis geeft aan dat een binnenkomend bericht niet kon worden gedeserialiseerd, niet dat er een willekeurige communicatiefout is.
Versie: WHATWG HTML Living Standard; index snapshot date recorded separately
Syntax
<body onmessageerror="handler(event)">
window.onmessageerror = handler;
window.addEventListener("messageerror", handler);onmessageerror is een HTML-eventhandlerattribuut voor messageerror. Op body stelt het een handler in voor het bijbehorende Window, niet voor een gebeurtenis die op het element zelf is gericht. Het is geen globaal attribuut voor willekeurige elementen. De attribuutwaarde is JavaScript-code; de parameter event geeft toegang tot een MessageEvent.
Bij communicatie via postMessage() reconstrueert de ontvanger de verzonden gegevens met gestructureerde deserialisatie. Als die stap mislukt, ontvangt de ontvanger messageerror in plaats van message. Dit is geen algemene melding van verloren berichten en ook geen fout bij het uitvoeren van code van de ontvanger. Een serialisatiefout aan de kant van de verzender kan in plaats daarvan een synchrone DataCloneError-uitzondering veroorzaken bij de aanroep van postMessage().
Wijs in JavaScript een functie toe aan window.onmessageerror of gebruik window.addEventListener("messageerror", handler). Het attribuut op body en de eigenschap window.onmessageerror verwijzen naar dezelfde handler; een volgende toewijzing vervangt die, en toewijzing van null verwijdert hem. Met addEventListener() kunnen onafhankelijke luisteraars worden toegevoegd.
Het voorbeeld verstuurt bewust een synthetische gebeurtenis naar window voor een deterministisch resultaat. Het controleert de koppeling van het attribuut aan de eventhandler, maar veroorzaakt geen echte deserialisatiefout. Een beveiligingsbeleid dat inline scripts of inline eventhandlers blokkeert, kan uitvoering verhinderen.
Voorbeelden
<!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>Resultaat
messageerror
De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.