CKTIS / JavaScript
Worker.postMessage — inviare dati a un worker
Worker.postMessage invia dati a un worker dedicato tramite un canale di messaggi asincrono. I dati vengono clonati strutturalmente; una lista di trasferimento facoltativa consente di trasferire risorse come ArrayBuffer invece di copiarle.
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
worker.postMessage(message)
worker.postMessage(message, transfer)
worker.postMessage(message, { transfer })Worker.postMessage indica un metodo di istanza di Worker, non un metodo statico del costruttore. La chiamata worker.postMessage(message) invia dati a un worker dedicato. Una chiamata riuscita non garantisce la consegna: il worker può terminare prima che venga generato l’evento. Se la deserializzazione non riesce dal lato del destinatario, quest’ultimo riceve un evento messageerror anziché message. Quando riceve un evento message, il destinatario legge i dati da event.data. Il metodo restituisce undefined, non una Promise; il fatto che la chiamata termini non significa che il destinatario abbia finito il proprio lavoro.
Il messaggio viene clonato strutturalmente, non serializzato tramite JSON. Sono supportati, tra gli altri valori, oggetti semplici e array; le funzioni non sono supportate e causano un’eccezione sincrona DataCloneError. Non dare per scontato che i prototipi delle classi personalizzate vengano mantenuti. La consegna è asincrona, ma la serializzazione avviene durante la chiamata e può impegnare il mittente.
Il secondo argomento facoltativo è una lista transfer oppure un oggetto { transfer }. Trasferire un ArrayBuffer scollega il buffer del mittente: il suo byteLength diventa 0. Il buffer deve anche essere raggiungibile da message perché il destinatario possa accedervi; la lista di trasferimento da sola non lo aggiunge ai dati del messaggio. Trasferisci il buffer di un array tipizzato, non l’array tipizzato stesso come elemento della lista di trasferimento.
Invia una risposta all’interno del worker con self.postMessage(...) e ricevila sull’oggetto worker. Non è window.postMessage: non c’è un argomento targetOrigin. SharedWorker usa worker.port.postMessage(...). Questa API è definita da HTML Living Standard, non da un’edizione di ECMAScript. Il metodo di base è supportato nei moderni motori dei browser; verifica separatamente la compatibilità della forma di trasferimento utilizzata. Node 24 non dimostra la disponibilità di questa API del browser.
Esempi
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);Risultato
sender bytes: 0 sum: 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.