CKTIS / JavaScript
DedicatedWorkerGlobalScope.postMessage() — Nachrichten aus einem Worker senden
DedicatedWorkerGlobalScope.postMessage sendet Daten von einem dedizierten Worker an dessen Ersteller. Der Empfänger liest sie über event.data aus. Die Methode unterstützt strukturierte Klonierung und die optionale Übertragung des Eigentums an Objekten.
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
self.postMessage(message)
self.postMessage(message, transfer)
self.postMessage(message, { transfer })DedicatedWorkerGlobalScope.postMessage ist eine Web-API-Methode, die in einem dedizierten Worker als self.postMessage() verfügbar ist. Sie sendet eine Nachricht an den Ersteller des Workers. Der Empfänger verarbeitet das message-Ereignis am Worker-Objekt und liest event.data aus. In die entgegengesetzte Richtung funktioniert Worker.postMessage().
Das Argument message enthält einen einzelnen Wert; mehrere Werte lassen sich in einem Objekt oder Array bündeln. Die strukturierte Klonierung unterstützt auch zirkuläre Verweise. Das optionale Array transfer, das direkt oder als { transfer } übergeben wird, überträgt das Eigentum an unterstützten Objekten, statt sie zu kopieren. Auf der sendenden Seite können diese anschließend nicht mehr verwendet werden. Die Liste allein fügt keine Objekte zur Nachricht hinzu: Sie müssen darin enthalten oder dem Empfänger auf anderem Weg zugänglich sein.
Die Methode gibt undefined zurück, nicht die Antwort des Empfängers. Dies ist eine Browser-API und keine ECMAScript-Funktion; MDN kennzeichnet sie als allgemein verfügbar. Das Beispiel erstellt einen dedizierten Worker, sendet 21 und gibt die Antwort 42 aus.
Beispiele
const source = `
self.onmessage = (event) => {
self.postMessage(event.data * 2);
};
`;
const url = URL.createObjectURL(
new Blob([source], { type: "text/javascript" })
);
const worker = new Worker(url);
worker.onmessage = (event) => {
console.log(event.data);
worker.terminate();
URL.revokeObjectURL(url);
};
worker.onerror = () => {
worker.terminate();
URL.revokeObjectURL(url);
console.error("Worker failed");
};
worker.postMessage(21);Ergebnis
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.