CKTIS / JavaScript
DedicatedWorkerGlobalScope.postMessage() — slanje poruka iz workera
DedicatedWorkerGlobalScope.postMessage šalje podatke iz namjenskog workera njegovu tvorcu. Primatelj ih čita putem event.data. Metoda podržava strukturirano kloniranje i neobvezan prijenos vlasništva nad objektima.
Verzija: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintaksa
self.postMessage(message)
self.postMessage(message, transfer)
self.postMessage(message, { transfer })DedicatedWorkerGlobalScope.postMessage metoda je Web API-ja dostupna unutar namjenskog workera kao self.postMessage(). Šalje poruku njegovu tvorcu. Primatelj obrađuje događaj message na objektu Worker i čita event.data. U suprotnom smjeru djeluje Worker.postMessage().
Argument message sadrži jednu vrijednost; više stavki možeš objediniti u objektu ili nizu. Strukturirano kloniranje podržava i cikličke reference. Neobvezni niz transfer, zadan izravno ili kao { transfer }, prenosi vlasništvo nad podržanim objektima umjesto da ih kopira. Nakon toga ne mogu se više upotrebljavati na strani pošiljatelja. Sam popis ne dodaje objekte u poruku: moraju biti sadržani u njoj ili na drugi način dostupni primatelju.
Metoda vraća undefined, a ne odgovor primatelja. To je API preglednika, a ne značajka ECMAScripta; MDN ga označava kao široko dostupan. Primjer stvara namjenski worker, šalje 21 i ispisuje odgovor 42.
Primjeri
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);Rezultat
42
Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.