Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / JavaScript

Worker.postMessage — pošiljanje podatkov workerju

Worker.postMessage pošilja podatke namenskemu workerju prek asinhronega kanala za sporočila. Podatki se strukturno klonirajo; izbirni seznam za prenos omogoča prenos virov, kot je ArrayBuffer, namesto njihovega kopiranja.

Različica: 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čuje instančno metodo objekta Worker, ne statične metode konstruktorja. Klic worker.postMessage(message) pošlje podatke namenskemu workerju. Uspešen klic ne zagotavlja dostave: worker lahko preneha delovati, preden se dogodek sproži. Če deserializacija pri prejemniku ne uspe, se pri njem namesto dogodka message sproži dogodek messageerror. Ob dogodku message prejemnik prebere podatke iz event.data. Metoda vrne undefined, ne Promise; vrnitev iz klica ne pomeni, da je prejemnik končal svoje delo.

Sporočilo se strukturno klonira, ne serializira prek JSON. Med drugim so podprti običajni objekti in polja; funkcije niso podprte in povzročijo sinhrono izjemo DataCloneError. Ne predpostavljajte, da se bodo ohranili prototipi lastnih razredov. Dostava je asinhrona, vendar serializacija poteka med klicem in lahko obremeni pošiljatelja.

Izbirni drugi argument je seznam transfer ali objekt { transfer }. Prenos ArrayBuffer odklopi medpomnilnik pošiljatelja: njegov byteLength je nato 0. Medpomnilnik mora biti dosegljiv tudi prek message, da lahko prejemnik dostopa do njega; sam seznam za prenos ga ne doda med podatke sporočila. Prenesite medpomnilnik tipiziranega polja, ne pa samega tipiziranega polja kot elementa seznama za prenos.

Odgovor pošljite iz workerja z self.postMessage(...) in ga prejmite na objektu worker. To ni window.postMessage: nima argumenta targetOrigin. SharedWorker uporablja worker.port.postMessage(...). Ta API določa HTML Living Standard, ne izdaja ECMAScript. Osnovno metodo podpirajo sodobni brskalniški pogoni; združljivost uporabljene oblike prenosa preverite posebej. Node 24 ne potrjuje razpoložljivosti tega brskalniškega API-ja.

Primeri

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

Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.

Viri