CKTIS / JavaScript
Worker.postMessage — envoyer des données à un worker
Worker.postMessage envoie des données à un worker dédié par un canal de messages asynchrone. Les données sont clonées de manière structurée ; une liste de transfert facultative permet de transférer des ressources comme ArrayBuffer au lieu de les copier.
Version : ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntaxe
worker.postMessage(message)
worker.postMessage(message, transfer)
worker.postMessage(message, { transfer })Worker.postMessage désigne une méthode d’instance de Worker, et non une méthode statique du constructeur. L’appel worker.postMessage(message) envoie des données à un worker dédié. Même si l’appel se termine sans erreur, rien ne garantit que le message sera livré : le worker peut s’arrêter avant que l’événement ne soit déclenché. Si la désérialisation échoue côté destinataire, celui-ci reçoit un événement messageerror au lieu d’un événement message. Lorsqu’il reçoit un événement message, le destinataire lit les données dans event.data. La méthode renvoie undefined, et non une Promise ; son retour ne signifie pas que le destinataire a terminé son travail.
Le message est cloné de manière structurée, et non sérialisé via JSON. Les objets simples et les tableaux sont pris en charge, entre autres valeurs ; les fonctions ne le sont pas et provoquent une exception synchrone DataCloneError. Ne partez pas du principe que les prototypes des classes personnalisées seront préservés. La livraison est asynchrone, mais la sérialisation a lieu pendant l’appel et peut solliciter l’émetteur.
Le deuxième argument, facultatif, est une liste transfer ou un objet { transfer }. Le transfert d’un ArrayBuffer détache le tampon de l’émetteur : son byteLength devient alors 0. Le tampon doit aussi être accessible depuis message pour que le destinataire puisse l’utiliser ; la liste de transfert ne l’ajoute pas à elle seule aux données du message. Transférez le tampon d’un tableau typé, et non le tableau typé lui-même comme élément de la liste de transfert.
Envoyez une réponse depuis le worker avec self.postMessage(...) et recevez-la sur l’objet worker. Il ne s’agit pas de window.postMessage : il n’y a pas d’argument targetOrigin. SharedWorker utilise worker.port.postMessage(...). Cette API est définie par le HTML Living Standard, et non par une édition d’ECMAScript. La méthode de base est prise en charge par les moteurs de navigateur modernes ; vérifiez séparément la compatibilité de la forme de transfert utilisée. Node 24 ne permet pas d’établir la disponibilité de cette API de navigateur.
Exemples
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);Résultat
sender bytes: 0 sum: 42
Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.