CKTIS / JavaScript
DedicatedWorkerGlobalScope.postMessage() — inviare messaggi da un worker
DedicatedWorkerGlobalScope.postMessage invia dati da un worker dedicato a chi lo ha creato. Il destinatario li legge tramite event.data. Il metodo supporta la clonazione strutturata e il trasferimento facoltativo della proprietà degli oggetti.
Versione: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintassi
self.postMessage(message)
self.postMessage(message, transfer)
self.postMessage(message, { transfer })DedicatedWorkerGlobalScope.postMessage è un metodo dell’API Web disponibile all’interno di un worker dedicato come self.postMessage(). Invia un messaggio a chi ha creato il worker. Il destinatario gestisce l’evento message sull’oggetto Worker e legge event.data. Nella direzione opposta si usa Worker.postMessage().
L’argomento message contiene un singolo valore; puoi raggruppare più elementi in un oggetto o in un array. La clonazione strutturata supporta anche i riferimenti ciclici. L’array facoltativo transfer, fornito direttamente o come { transfer }, trasferisce la proprietà degli oggetti supportati invece di copiarli. In seguito, non è più possibile usarli dal lato mittente. L’elenco da solo non aggiunge oggetti al messaggio: devono essere inclusi nel messaggio o accessibili al destinatario in altro modo.
Il metodo restituisce undefined, non la risposta del destinatario. È un’API del browser, non una funzionalità ECMAScript; MDN la indica come ampiamente disponibile. L’esempio crea un worker dedicato, invia 21 e mostra la risposta 42.
Esempi
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);Risultato
42
Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.