CKTIS / HTML
onmessageerror — Fehler bei der Deserialisierung von Nachrichten behandeln
Das Attribut onmessageerror auf body legt den messageerror-Handler des Window-Objekts fest. Das Ereignis weist auf eine fehlgeschlagene Deserialisierung einer eingehenden Nachricht hin, nicht auf einen beliebigen Kommunikationsfehler.
Version: WHATWG HTML Living Standard; index snapshot date recorded separately
Syntax
<body onmessageerror="handler(event)">
window.onmessageerror = handler;
window.addEventListener("messageerror", handler);onmessageerror ist ein HTML-Event-Handler-Attribut für messageerror. Auf body legt es einen Handler für das zugehörige Window fest, nicht für ein Ereignis, das auf das Element selbst zielt. Es ist kein globales Attribut für beliebige Elemente. Der Attributwert ist JavaScript-Code; der Parameter event stellt ein MessageEvent bereit.
Bei der Kommunikation über postMessage() rekonstruiert der Empfänger die übertragenen Daten durch strukturierte Deserialisierung. Schlägt dieser Schritt fehl, erhält er messageerror statt message. Das ist weder eine allgemeine Meldung über verlorene Nachrichten noch ein Fehler beim Ausführen des Empfängercodes. Ein Serialisierungsfehler auf der Senderseite kann stattdessen beim Aufruf von postMessage() synchron eine DataCloneError-Ausnahme auslösen.
Weisen Sie in JavaScript eine Funktion window.onmessageerror zu oder verwenden Sie window.addEventListener("messageerror", handler). Das Attribut auf body und die Eigenschaft window.onmessageerror beziehen sich auf denselben Handler; eine weitere Zuweisung ersetzt ihn, und die Zuweisung von null entfernt ihn. Mit addEventListener() lassen sich unabhängige Listener hinzufügen.
Das Beispiel löst absichtlich ein synthetisches Ereignis auf window aus, um ein deterministisches Ergebnis zu erhalten. Es prüft die Verbindung des Attributs mit dem Event-Handler, verursacht aber keinen tatsächlichen Deserialisierungsfehler. Eine Sicherheitsrichtlinie, die Inline-Skripte oder Inline-Event-Handler blockiert, kann die Ausführung verhindern.
Beispiele
<!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>Ergebnis
messageerror
Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.