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

CKTIS / JavaScript

DedicatedWorkerGlobalScope.postMessage() — odesílání zpráv z workeru

DedicatedWorkerGlobalScope.postMessage odesílá data z dedikovaného workeru jeho tvůrci. Příjemce je čte přes event.data. Metoda podporuje strukturované klonování a volitelný převod vlastnictví objektů.

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

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

DedicatedWorkerGlobalScope.postMessage je metoda Web API dostupná uvnitř dedikovaného workeru jako self.postMessage(). Odesílá zprávu jeho tvůrci. Příjemce zpracuje událost message na objektu Worker a přečte event.data. Opačným směrem funguje Worker.postMessage().

Argument message obsahuje jednu hodnotu; více položek lze zabalit do objektu nebo pole. Strukturované klonování podporuje také cyklické odkazy. Volitelné pole transfer, předané přímo nebo jako { transfer }, převádí vlastnictví podporovaných objektů místo jejich kopírování. Na straně odesílatele je pak už nelze používat. Samotný seznam objekty do zprávy nepřidá: musí být její součástí nebo musí být příjemci dostupné jiným způsobem.

Metoda vrací undefined, nikoli odpověď příjemce. Jde o API prohlížeče, nikoli o funkci ECMAScriptu; MDN ji označuje jako široce dostupnou. Příklad vytvoří dedikovaný worker, odešle 21 a vypíše odpověď 42.

Příklady

const source = `
self.onmessage = (event) => {
  self.postMessage(event.data * 2);
};
`;
const url = URL.createObjectURL(
  new Blob([source], { type: "text/javascript" })
);
const worker = new Worker(url);

worker.onmessage = (event) => {
  console.log(event.data);
  worker.terminate();
  URL.revokeObjectURL(url);
};
worker.onerror = () => {
  worker.terminate();
  URL.revokeObjectURL(url);
  console.error("Worker failed");
};
worker.postMessage(21);

Výsledek

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