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

CKTIS / JavaScript

Worker.terminate() : arrêter un worker de force

worker.terminate() arrête un worker dédié depuis du code qui détient son objet Worker. La méthode ne prend aucun argument et renvoie undefined ; elle ne garantit ni la fin de la tâche en cours ni l’exécution du code de nettoyage.

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.terminate()

worker.terminate() est une méthode d’instance de Worker définie par le HTML Standard, et non par ECMAScript. Elle arrête un worker dédié. Le code qui détient son objet Worker appelle cette méthode.

L’arrêt supprime les tâches en attente du worker et interrompt le script en cours d’exécution. Ne comptez pas sur l’exécution d’un bloc finally ni sur l’envoi d’un dernier message.

La méthode ne prend aucun argument, renvoie undefined et ne fournit aucune promesse confirmant la fin de l’arrêt. self.close() s’utilise à l’intérieur du worker et permet à la tâche en cours de se terminer. Si le nettoyage est important, concevez un protocole de messages avec accusé de réception avant l’arrêt forcé.

L’exemple reçoit 42, appelle terminate() et libère l’URL d’objet Blob. Exécutez-le dans un navigateur qui autorise les workers blob: ; le résultat attendu est une ligne contenant 42. Le résultat seul ne prouve pas que le worker a été arrêté.

Exemples

const url = URL.createObjectURL(new Blob([
  'self.onmessage = () => self.postMessage(42);'
], { type: 'text/javascript' }));
const worker = new Worker(url);
worker.onmessage = ({ data }) => {
  worker.terminate();
  URL.revokeObjectURL(url);
  console.log(data);
};
worker.postMessage('start');

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.

Sources