WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / JavaScript

messageerror — Deserialisierungsfehler bei Worker-Nachrichten

Das messageerror-Ereignis auf einem Worker signalisiert, dass eine eingehende Nachricht nicht deserialisiert werden konnte. Unterscheide es von einem Sendefehler bei postMessage() und vom error-Ereignis, das mit einem Worker-Fehler verbunden ist.

Version: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Syntax

worker.addEventListener("messageerror", (event) => { /* handle receive failure */ });
worker.onmessageerror = (event) => { /* handle receive failure */ };

Das messageerror event wird auf einem Worker-Objekt ausgelöst, wenn eine eingehende Nachricht vom Worker nicht deserialisiert werden kann, ihr Wert also auf der Empfängerseite nicht wiederhergestellt werden kann. Es gehört zu den Web APIs und nicht zu einer bestimmten ECMAScript-Version. Das Ereignis ist ein MessageEvent. Es hat keine Bubbling-Phase und kann nicht abgebrochen werden.

Registriere einen Handler mit worker.addEventListener("messageerror", handler) oder weise worker.onmessageerror eine Funktion zu. Die erste Form erlaubt mehrere Listener; die zweite setzt eine einzelne Handler-Eigenschaft. Die Richtung ist wichtig: Ein Listener auf Worker behandelt den Empfang im Code, der den Worker erstellt hat. Verwende innerhalb eines dedizierten Workers self.addEventListener("messageerror", handler), um den Empfang vom Ersteller zu behandeln.

Verwechsle dieses Ereignis nicht mit jedem Kommunikationsproblem. Der Versuch, einen nicht klonbaren Wert zu senden, kann in postMessage() synchron einen DataCloneError auslösen — behandle ihn beim Sender mit try...catch. Das error-Ereignis betrifft einen Worker-Fehler und nicht speziell die Deserialisierung einer Nachricht. messageerror dient auch nicht zur Validierung von Anwendungsdaten; eine erfolgreich empfangene Nachricht muss weiterhin geprüft werden.

Das Beispiel löst absichtlich ein synthetisches MessageEvent auf einem einfachen EventTarget aus. So zeigt es deterministisch den Aufruf des Listeners und die Ereignis-Flags, ohne Worker-Dateien zu benötigen. Es erzeugt keinen tatsächlichen Deserialisierungsfehler und belegt keine native Ereignisunterstützung auf Worker. MDN kennzeichnet die Worker-Variante als nur eingeschränkt verfügbar: Prüfe die Kompatibilität mit deinen Zielbrowsern. Dass sich Node 24 in einem Repository befindet, beweist keine Browserunterstützung für diese API.

Beispiele

(() => {
  const target = new EventTarget();
  target.addEventListener("messageerror", (event) => {
    console.log(`${event.type}: bubbles=${event.bubbles}, cancelable=${event.cancelable}`);
  });
  target.dispatchEvent(new MessageEvent("messageerror"));
})();

Ergebnis

messageerror: bubbles=false, cancelable=false

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.

Quellen