WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / JavaScript

Worker.postMessage — Daten an einen Worker senden

Worker.postMessage sendet Daten über einen asynchronen Nachrichtenkanal an einen dedizierten Worker. Die Daten werden strukturiert geklont; eine optionale Transferliste ermöglicht es, Ressourcen wie ArrayBuffer zu übertragen, statt sie zu kopieren.

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.postMessage(message)
worker.postMessage(message, transfer)
worker.postMessage(message, { transfer })

Worker.postMessage bezeichnet eine Instanzmethode von Worker, keine statische Methode des Konstruktors. Mit worker.postMessage(message) werden Daten an einen dedizierten Worker gesendet. Ein erfolgreicher Aufruf garantiert keine Zustellung: Der Worker kann beendet werden, bevor das Ereignis ausgelöst wird. Schlägt die Deserialisierung auf der Empfängerseite fehl, erhält der Empfänger ein messageerror-Ereignis statt eines message-Ereignisses. Erhält der Empfänger ein message-Ereignis, liest er die Daten aus event.data. Die Methode gibt undefined zurück, kein Promise; die Rückkehr bedeutet nicht, dass der Empfänger seine Arbeit beendet hat.

Die Nachricht wird strukturiert geklont, nicht über JSON serialisiert. Unter anderem werden einfache Objekte und Arrays unterstützt; Funktionen werden nicht unterstützt und lösen synchron einen DataCloneError aus. Gehe nicht davon aus, dass Prototypen eigener Klassen erhalten bleiben. Die Zustellung ist asynchron, die Serialisierung findet jedoch während des Aufrufs statt und kann den Sender belasten.

Das optionale zweite Argument ist eine transfer-Liste oder ein Objekt { transfer }. Beim Übertragen eines ArrayBuffer wird der Puffer des Senders abgetrennt: Sein byteLength ist danach 0. Der Puffer muss außerdem von message aus erreichbar sein, damit der Empfänger darauf zugreifen kann; die Transferliste allein fügt ihn den Nachrichtendaten nicht hinzu. Übertrage den Puffer eines typisierten Arrays, nicht das typisierte Array selbst als Element der Transferliste.

Eine Antwort wird im Worker mit self.postMessage(...) gesendet und am Objekt worker empfangen. Dies ist nicht window.postMessage: Es gibt kein Argument targetOrigin. SharedWorker verwendet worker.port.postMessage(...). Diese API ist im HTML Living Standard definiert, nicht in einer ECMAScript-Ausgabe. Die grundlegende Methode wird von modernen Browser-Engines unterstützt; prüfe die Kompatibilität der verwendeten Transferform separat. Node 24 belegt nicht die Verfügbarkeit dieser Browser-API.

Beispiele

const source = `
self.onmessage = ({ data }) => {
  const values = new Uint8Array(data);
  self.postMessage(values[0] + values[1]);
};
`;
const url = URL.createObjectURL(new Blob([source], {
  type: 'text/javascript'
}));
const worker = new Worker(url);
const cleanup = () => {
  worker.terminate();
  URL.revokeObjectURL(url);
};
worker.onmessage = ({ data }) => {
  console.log('sum:', data);
  cleanup();
};
worker.onerror = () => {
  console.error('Worker failed');
  cleanup();
};
worker.onmessageerror = () => {
  console.error('Message decoding failed');
  cleanup();
};
const buffer = new Uint8Array([20, 22]).buffer;
worker.postMessage(buffer, [buffer]);
console.log('sender bytes:', buffer.byteLength);

Ergebnis

sender bytes: 0
sum: 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