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.