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

CKTIS / JavaScript

setTimeout — planifier une fonction une seule fois

setTimeout planifie l’exécution d’une fonction une seule fois, sans bloquer le code en cours. Le délai ne garantit pas une heure d’exécution exacte, et l’identifiant renvoyé permet d’annuler l’appel en attente.

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

const id = setTimeout(callback, delayMs, ...args);
clearTimeout(id);

setTimeout est une API définie par le HTML Standard pour les fenêtres et les workers, et non une fonction d’ECMAScript lui-même. Elle planifie l’appel d’une fonction une seule fois ; setInterval planifie des répétitions. Fournissez une fonction callback, un délai delayMs en millisecondes et des args facultatifs transmis à la fonction. Fournissez une fonction plutôt qu’un texte de code qui nécessiterait une compilation.

L’appel se termine sans attendre. Même avec un délai de 0, le callback attend une tâche ultérieure de la boucle d’événements ; il n’interrompt pas le code synchrone en cours. Le moment indiqué n’est pas garanti et l’exécution peut être plus tardive. Lorsque le niveau d’imbrication du timer dépasse 5, les délais inférieurs à 4 ms sont portés à 4 ms.

La planification d’une fonction renvoie un identifiant entier positif id. clearTimeout(id) annule l’appel en attente dans le même environnement global. Cela n’arrête pas un callback déjà en cours d’exécution.

L’exemple annule un timer et transmet "timer" comme argument à un autre. Le code synchrone ajoute "end" avant l’exécution du callback du timer ; le résultat attendu est donc start -> end -> timer. Vérifiez l’ordre, pas la durée exacte écoulée.

Exemples

(() => {
  const events = ["start"];
  const id = setTimeout(() => events.push("cancelled"), 0);
  clearTimeout(id);

  setTimeout((message) => {
    events.push(message);
    console.log(events.join(" -> "));
  }, 0, "timer");

  events.push("end");
})();

Résultat

start -> end -> timer

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