Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

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.

Fonti