CKTIS / JavaScript
DedicatedWorkerGlobalScope.postMessage() — odosielanie správ z workera
DedicatedWorkerGlobalScope.postMessage odosiela údaje z dedikovaného workera jeho tvorcovi. Príjemca ich číta cez event.data. Metóda podporuje štruktúrované klonovanie a voliteľný prevod vlastníctva objektov.
Verzia: 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 je metóda Web API dostupná v dedikovanom workerovi ako self.postMessage(). Odosiela správu jeho tvorcovi. Príjemca spracuje udalosť message na objekte Worker a prečíta event.data. Opačným smerom funguje Worker.postMessage().
Argument message obsahuje jednu hodnotu; viacero položiek možno zabaliť do objektu alebo poľa. Štruktúrované klonovanie podporuje aj cyklické odkazy. Voliteľné pole transfer, zadané priamo alebo ako { transfer }, prevádza vlastníctvo podporovaných objektov namiesto ich kopírovania. Na strane odosielateľa ich potom už nemožno používať. Samotný zoznam objekty do správy nepridá: musia byť jej súčasťou alebo musia byť príjemcovi dostupné iným spôsobom.
Metóda vracia undefined, nie odpoveď príjemcu. Ide o API prehliadača, nie o funkciu ECMAScriptu; MDN ju označuje ako široko dostupnú. Príklad vytvorí dedikovaný worker, odošle 21 a vypíše odpoveď 42.
Prí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ýsledok
42
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.