CKTIS / JavaScript
DedicatedWorkerGlobalScope.postMessage() — odesílání zpráv z workeru
DedicatedWorkerGlobalScope.postMessage odesílá data z dedikovaného workeru jeho tvůrci. Příjemce je čte přes event.data. Metoda podporuje strukturované klonování a volitelný převod vlastnictví objektů.
Verze: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntaxe
self.postMessage(message)
self.postMessage(message, transfer)
self.postMessage(message, { transfer })DedicatedWorkerGlobalScope.postMessage je metoda Web API dostupná uvnitř dedikovaného workeru jako self.postMessage(). Odesílá zprávu jeho tvůrci. Příjemce zpracuje událost message na objektu Worker a přečte event.data. Opačným směrem funguje Worker.postMessage().
Argument message obsahuje jednu hodnotu; více položek lze zabalit do objektu nebo pole. Strukturované klonování podporuje také cyklické odkazy. Volitelné pole transfer, předané přímo nebo jako { transfer }, převádí vlastnictví podporovaných objektů místo jejich kopírování. Na straně odesílatele je pak už nelze používat. Samotný seznam objekty do zprávy nepřidá: musí být její součástí nebo musí být příjemci dostupné jiným způsobem.
Metoda vrací undefined, nikoli odpověď příjemce. Jde o API prohlížeče, nikoli o funkci ECMAScriptu; MDN ji označuje jako široce dostupnou. Příklad vytvoří dedikovaný worker, odešle 21 a vypíše odpověď 42.
Příklady
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);Výsledek
42
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.