CKTIS / JavaScript
DedicatedWorkerGlobalScope.postMessage() — envoyer des messages depuis un worker
DedicatedWorkerGlobalScope.postMessage envoie des données depuis un worker dédié à son créateur. Le destinataire les lit avec event.data. La méthode prend en charge le clonage structuré et le transfert facultatif de la propriété des objets.
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
self.postMessage(message)
self.postMessage(message, transfer)
self.postMessage(message, { transfer })DedicatedWorkerGlobalScope.postMessage est une méthode de l’API Web disponible dans un worker dédié sous la forme self.postMessage(). Elle envoie un message au créateur du worker. Le destinataire traite l’événement message sur l’objet Worker et lit event.data. Dans le sens inverse, on utilise Worker.postMessage().
L’argument message contient une seule valeur ; regroupez plusieurs éléments dans un objet ou un tableau. Le clonage structuré prend également en charge les références cycliques. Le tableau facultatif transfer, fourni directement ou sous la forme { transfer }, transfère la propriété des objets pris en charge au lieu de les copier. Ils ne peuvent ensuite plus être utilisés du côté de l’envoi. La liste, à elle seule, n’ajoute pas d’objets au message : ceux-ci doivent y être inclus ou être accessibles au destinataire par un autre moyen.
La méthode renvoie undefined, et non la réponse du destinataire. Il s’agit d’une API de navigateur, pas d’une fonctionnalité ECMAScript ; MDN la marque comme largement disponible. L’exemple crée un worker dédié, envoie 21 et affiche la réponse 42.
Exemples
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);Résultat
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.