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

CKTIS / JavaScript

Worker.postMessage — odosielanie dát workeru

Worker.postMessage odosiela dáta dedikovanému workeru cez asynchrónny kanál správ. Dáta sa štrukturálne klonujú; voliteľný zoznam na prenos umožňuje preniesť zdroje, napríklad ArrayBuffer, namiesto ich kopírovania.

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

worker.postMessage(message)
worker.postMessage(message, transfer)
worker.postMessage(message, { transfer })

Worker.postMessage označuje inštančnú metódu objektu Worker, nie statickú metódu konštruktora. Volanie worker.postMessage(message) odošle dáta dedikovanému workeru. Úspešné volanie nezaručuje doručenie: worker môže ukončiť činnosť skôr, ako sa vyvolá udalosť. Ak deserializácia na strane príjemcu zlyhá, príjemca dostane udalosť messageerror namiesto message. Keď príjemca dostane udalosť message, prečíta dáta z event.data. Metóda vracia undefined, nie Promise; návrat z volania neznamená, že príjemca dokončil svoju prácu.

Správa sa štrukturálne klonuje, neserializuje sa cez JSON. Podporované sú okrem iného bežné objekty a polia; funkcie podporované nie sú a spôsobia synchrónnu výnimku DataCloneError. Nepredpokladajte, že sa zachovajú prototypy vlastných tried. Doručenie je asynchrónne, ale serializácia prebieha počas volania a môže zaťažiť odosielateľa.

Voliteľným druhým argumentom je zoznam transfer alebo objekt { transfer }. Prenesením ArrayBuffer sa buffer odosielateľa odpojí: jeho byteLength bude potom 0. Buffer musí byť tiež dosiahnuteľný z message, aby k nemu príjemca mohol pristupovať; samotný zoznam na prenos ho do dát správy nepridá. Prenášajte buffer typovaného poľa, nie samotné typované pole ako položku zoznamu na prenos.

Odpoveď odošlite vo vnútri workeru pomocou self.postMessage(...) a prijmite ju na objekte worker. Nejde o window.postMessage: nemá argument targetOrigin. SharedWorker používa worker.port.postMessage(...). Toto API definuje HTML Living Standard, nie vydanie ECMAScriptu. Základná metóda je podporovaná v moderných prehliadačových enginoch; kompatibilitu použitej podoby prenosu overte osobitne. Node 24 nepotvrdzuje dostupnosť tohto prehliadačového API.

Príklady

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);

Výsledok

sender bytes: 0
sum: 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