CKTIS / JavaScript
Worker.postMessage — slanje podataka workeru
Worker.postMessage šalje podatke namjenskom workeru putem asinkronog kanala za poruke. Podaci se strukturirano kloniraju; neobavezni popis za prijenos omogućuje prijenos resursa poput ArrayBuffer umjesto njihova kopiranja.
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
worker.postMessage(message)
worker.postMessage(message, transfer)
worker.postMessage(message, { transfer })Worker.postMessage označava instancijsku metodu objekta Worker, a ne statičku metodu konstruktora. Poziv worker.postMessage(message) šalje podatke namjenskom workeru. Uspješan poziv ne jamči dostavu: worker može prestati s radom prije nego što se događaj pokrene. Ako deserijalizacija na strani primatelja ne uspije, primatelj dobiva događaj messageerror umjesto događaja message. Kad dobije događaj message, primatelj čita podatke iz event.data. Metoda vraća undefined, a ne Promise; povratak iz poziva ne znači da je primatelj dovršio svoj posao.
Poruka se strukturirano klonira, a ne serijalizira putem JSON-a. Podržani su, među ostalim, obični objekti i polja; funkcije nisu podržane i uzrokuju sinkronu iznimku DataCloneError. Nemojte pretpostaviti da će se sačuvati prototipovi prilagođenih klasa. Dostava je asinkrona, ali serijalizacija se odvija tijekom poziva i može opteretiti pošiljatelja.
Neobavezni drugi argument jest popis transfer ili objekt { transfer }. Prijenosom ArrayBuffer odspaja se međuspremnik pošiljatelja: njegov byteLength tada postaje 0. Međuspremnik mora biti dohvatljiv i iz message kako bi mu primatelj mogao pristupiti; sam popis za prijenos ne dodaje ga podacima poruke. Prenesite međuspremnik tipiziranog polja, a ne samo tipizirano polje kao stavku popisa za prijenos.
Odgovor pošaljite unutar workera pomoću self.postMessage(...), a primite ga na objektu worker. Ovo nije window.postMessage: nema argumenta targetOrigin. SharedWorker upotrebljava worker.port.postMessage(...). Ovaj API definira HTML Living Standard, a ne izdanje ECMAScripta. Osnovnu metodu podržavaju moderni preglednički pogoni; kompatibilnost upotrijebljenog oblika prijenosa provjerite zasebno. Node 24 ne potvrđuje dostupnost ovog pregledničkog API-ja.
Primjeri
const source = `
self.onmessage = ({ data }) => {
const values = new Uint8Array(data);
self.postMessage(values[0] + values[1]);
};
`;
const url = URL.createObjectURL(new Blob([source], {
type: 'text/javascript'
}));
const worker = new Worker(url);
const cleanup = () => {
worker.terminate();
URL.revokeObjectURL(url);
};
worker.onmessage = ({ data }) => {
console.log('sum:', data);
cleanup();
};
worker.onerror = () => {
console.error('Worker failed');
cleanup();
};
worker.onmessageerror = () => {
console.error('Message decoding failed');
cleanup();
};
const buffer = new Uint8Array([20, 22]).buffer;
worker.postMessage(buffer, [buffer]);
console.log('sender bytes:', buffer.byteLength);Rezultat
sender bytes: 0 sum: 42
Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.