WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / JavaScript

Worker-Ereignisse: Nachrichten und Fehler

Worker.onmessage empfängt Antworten des Workers, Worker.onerror meldet Fehler des Workers und Worker.onmessageerror behandelt die fehlgeschlagene Deserialisierung einer eingehenden Nachricht. Diese drei Handler gehören zum Worker-Objekt im Code, der den Worker erstellt hat.

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.onmessage = (event) => { /* event.data */ };
worker.onerror = (event) => { /* worker failure */ };
worker.onmessageerror = (event) => { /* deserialization failure */ };

Worker.onmessage, Worker.onerror und Worker.onmessageerror bezeichnen Eigenschaften, die einer Instanz zugewiesen werden, etwa worker.onmessage. Sie behandeln auf der Erzeugerseite eines Dedicated Workers jeweils die Ereignisse message, error und messageerror. Dies sind Web-APIs, die im HTML-Standard festgelegt sind, keine Funktionen einer bestimmten ECMAScript-Version.

Worker.onmessage empfängt ein MessageEvent; der übermittelte Wert steht in event.data. Der Aufruf von worker.postMessage(value) sendet Daten an den Worker, während self.postMessage(value) innerhalb des Workers eine Antwort sendet. Worker.onerror erhält dagegen ein Ereignisargument, das einen Worker-Fehler meldet. Verwechsle es nicht mit self.onerror innerhalb des Workers, das eine historische Signatur mit mehreren Argumenten hat.

Worker.onmessageerror empfängt ein MessageEvent, wenn eine eingehende Nachricht nicht deserialisiert werden kann. Es ist weder ein allgemeiner Handler für Berechnungsfehler noch ein Ersatz für die Behandlung von Ausnahmen auf der Sendeseite. An postMessage() übergebene Daten müssen vom Structured-Clone-Algorithmus unterstützt werden. Weder message noch messageerror wird nach oben weitergereicht oder kann abgebrochen werden.

Alternativen sind addEventListener("message", handler), addEventListener("error", handler) und addEventListener("messageerror", handler). MDN kennzeichnet message und error als breit verfügbar, messageerror jedoch als eingeschränkt verfügbar; prüfe die Zielbrowser. Dass Node 24 in einem Repository vorhanden ist, belegt nicht die Browserunterstützung dieser APIs.

Beispiele

(() => {
  const source = 'self.onmessage = (event) => { self.postMessage(event.data * 2); };';
  const url = URL.createObjectURL(new Blob([source], { type: 'text/javascript' }));
  let worker;
  const cleanup = () => {
    worker?.terminate();
    URL.revokeObjectURL(url);
  };

  try {
    worker = new Worker(url);
    worker.onmessage = (event) => {
      console.log(`result: ${event.data}`);
      cleanup();
    };
    worker.onerror = () => {
      console.error('worker error');
      cleanup();
    };
    worker.onmessageerror = () => {
      console.error('message deserialization error');
      cleanup();
    };
    worker.postMessage(21);
  } catch (error) {
    cleanup();
    throw error;
  }
})();

Ergebnis

result: 42

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