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

CKTIS / JavaScript

clearTimeout — annuler un minuteur

clearTimeout(id) annule un appel en attente planifié avec setTimeout(). Pour l’annuler, passez l’identifiant du minuteur correspondant, et non le callback. L’argument est facultatif : sans argument, clearTimeout() utilise la valeur par défaut 0 et n’a aucun effet.

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

clearTimeout()
clearTimeout(id)

clearTimeout(id) annule le minuteur identifié par la valeur renvoyée par setTimeout(). La fonction renvoie undefined. Il s’agit d’une API de la norme HTML, disponible dans les fenêtres de navigateur et les workers, et non d’une partie d’ECMAScript lui-même. La norme indique une prise en charge dans tous les moteurs de navigateur actuels ; la présence de Node 24 ne démontre pas la prise en charge des API de navigateur.

Conservez l’identifiant et annulez le minuteur dans le même environnement global que celui où il a été créé. Un identifiant absent du registre des minuteurs ne change rien. L’annulation n’interrompt pas un callback déjà en cours d’exécution et n’annule pas ses effets.

clearTimeout() et clearInterval() partagent un registre : techniquement, chacune peut donc annuler les deux types de minuteurs. Pour plus de clarté, associez setTimeout() à clearTimeout() et setInterval() à clearInterval().

Dans l’exemple, l’annulation a lieu de manière synchrone, avant que le callback puisse s’exécuter. Un délai de 0 ne signifie pas une exécution immédiate ; le seul message affiché est donc cancelled.

Exemples

(() => {
  const id = setTimeout(() => console.log("unexpected"), 0);
  clearTimeout(id);
  console.log("cancelled");
})();

Résultat

cancelled

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