Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / JavaScript

Worker.postMessage — odesílání dat workeru

Worker.postMessage odesílá data dedikovanému workeru přes asynchronní kanál zpráv. Data se strukturálně klonují; volitelný seznam pro přenos umožňuje přenést prostředky, například ArrayBuffer, místo jejich kopírování.

Verze: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Syntaxe

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

Worker.postMessage označuje instanční metodu objektu Worker, nikoli statickou metodu konstruktoru. Volání worker.postMessage(message) odešle data dedikovanému workeru. Úspěšné volání nezaručuje doručení: worker může skončit dříve, než je událost vyvolána. Pokud se deserializace na straně příjemce nezdaří, příjemce obdrží událost messageerror namísto message. Když příjemce obdrží událost message, přečte data z event.data. Metoda vrací undefined, nikoli Promise; návrat z volání neznamená, že příjemce dokončil svou práci.

Zpráva se strukturálně klonuje, neserializuje se přes JSON. Podporovány jsou mimo jiné běžné objekty a pole; funkce podporovány nejsou a způsobí synchronní výjimku DataCloneError. Nepředpokládejte, že se zachovají prototypy vlastních tříd. Doručení je asynchronní, ale serializace probíhá během volání a může zatížit odesílatele.

Volitelným druhým argumentem je seznam transfer nebo objekt { transfer }. Přenesením ArrayBuffer se buffer odesílatele odpojí: jeho byteLength pak bude 0. Buffer musí být také dosažitelný z message, aby k němu příjemce mohl přistupovat; samotný seznam pro přenos jej do dat zprávy nepřidá. Přenášejte buffer typovaného pole, nikoli samotné typované pole jako položku seznamu pro přenos.

Odpověď odešlete uvnitř workeru pomocí self.postMessage(...) a přijměte ji na objektu worker. Nejde o window.postMessage: nemá argument targetOrigin. SharedWorker používá worker.port.postMessage(...). Toto API definuje HTML Living Standard, nikoli vydání ECMAScriptu. Základní metoda je podporována v moderních prohlížečových enginech; kompatibilitu použité podoby přenosu ověřte zvlášť. Node 24 nepotvrzuje dostupnost tohoto prohlížečového API.

Pří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ýsledek

sender bytes: 0
sum: 42

Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.

Zdroje