CKTIS / JavaScript
DedicatedWorkerGlobalScope.postMessage() — pošiljanje sporočil iz workerja
DedicatedWorkerGlobalScope.postMessage pošlje podatke iz namenskega workerja njegovemu ustvarjalcu. Prejemnik jih prebere prek event.data. Metoda podpira strukturirano kloniranje in neobvezen prenos lastništva objektov.
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
self.postMessage(message)
self.postMessage(message, transfer)
self.postMessage(message, { transfer })DedicatedWorkerGlobalScope.postMessage je metoda spletnega API-ja, ki je znotraj namenskega workerja na voljo kot self.postMessage(). Sporočilo pošlje njegovemu ustvarjalcu. Prejemnik obdela dogodek message na objektu Worker in prebere event.data. V nasprotni smeri deluje Worker.postMessage().
Argument message vsebuje eno vrednost; več elementov lahko združiš v objekt ali polje. Strukturirano kloniranje podpira tudi krožne reference. Izbirno polje transfer, podano neposredno ali kot { transfer }, prenese lastništvo podprtih objektov namesto njihovega kopiranja. Na strani pošiljatelja jih potem ni več mogoče uporabljati. Seznam sam po sebi objektov ne doda v sporočilo: biti morajo vključeni vanj ali pa morajo biti prejemniku dostopni kako drugače.
Metoda vrne undefined, ne pa odgovora prejemnika. To je API brskalnika, ne funkcija ECMAScripta; MDN ga označuje kot široko dostopnega. Primer ustvari namenski worker, pošlje 21 in izpiše odgovor 42.
Primeri
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);Rezultat
42
Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.