Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / JavaScript

Événements Worker : messages et erreurs

Worker.onmessage reçoit les réponses du worker, Worker.onerror signale les défaillances du worker et Worker.onmessageerror traite l’échec de désérialisation d’un message entrant. Ces trois gestionnaires appartiennent à l’objet Worker dans le code qui a créé le worker.

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.onmessage = (event) => { /* event.data */ };
worker.onerror = (event) => { /* worker failure */ };
worker.onmessageerror = (event) => { /* deserialization failure */ };

Worker.onmessage, Worker.onerror et Worker.onmessageerror désignent des propriétés attribuées à une instance, par exemple worker.onmessage. Elles gèrent respectivement les événements message, error et messageerror du côté créateur d’un worker dédié. Ce sont des API Web définies par HTML, et non des fonctionnalités d’une édition particulière d’ECMAScript.

Worker.onmessage reçoit un MessageEvent ; la valeur transmise se trouve dans event.data. L’appel de worker.postMessage(value) envoie des données au worker, tandis que self.postMessage(value) à l’intérieur du worker envoie une réponse. Worker.onerror, en revanche, reçoit un argument événement signalant une défaillance du worker. Ne le confondez pas avec self.onerror dans le worker, qui possède une signature historique à plusieurs arguments.

Worker.onmessageerror reçoit un MessageEvent lorsqu’un message entrant ne peut pas être désérialisé. Ce n’est ni un gestionnaire général des erreurs de calcul ni un remplacement de la gestion des exceptions côté expéditeur. Les données transmises à postMessage() doivent être prises en charge par l’algorithme de clonage structuré. Ni message ni messageerror ne remonte dans la propagation et aucun des deux ne peut être annulé.

Les alternatives sont addEventListener("message", handler), addEventListener("error", handler) et addEventListener("messageerror", handler). MDN indique que message et error sont largement disponibles, mais que messageerror a une disponibilité limitée ; vérifiez les navigateurs visés. La présence de Node 24 dans un dépôt ne prouve pas la prise en charge de ces API dans les navigateurs.

Exemples

(() => {
  const source = 'self.onmessage = (event) => { self.postMessage(event.data * 2); };';
  const url = URL.createObjectURL(new Blob([source], { type: 'text/javascript' }));
  let worker;
  const cleanup = () => {
    worker?.terminate();
    URL.revokeObjectURL(url);
  };

  try {
    worker = new Worker(url);
    worker.onmessage = (event) => {
      console.log(`result: ${event.data}`);
      cleanup();
    };
    worker.onerror = () => {
      console.error('worker error');
      cleanup();
    };
    worker.onmessageerror = () => {
      console.error('message deserialization error');
      cleanup();
    };
    worker.postMessage(21);
  } catch (error) {
    cleanup();
    throw error;
  }
})();

Résultat

result: 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.

Sources