Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

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.

Zdroje