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

CKTIS / JavaScript

IdleDeadline — budget de temps d’un callback d’inactivité

IdleDeadline est l’objet transmis à un callback requestIdleCallback(). Il fournit une estimation du temps restant et indique si le callback a été exécuté à la suite de l’expiration du délai d’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

window.requestIdleCallback((deadline) => { deadline.didTimeout; deadline.timeRemaining(); }, { timeout: 1000 });

IdleDeadline est une interface de l’API Web exposée sur Window, et ne fait pas partie d’ECMAScript. Le navigateur la fournit à un callback requestIdleCallback() ; ne la construisez pas avec new IdleDeadline(). Vérifiez la disponibilité de l’API ; Node 24 ne prouve pas sa prise en charge dans un navigateur.

IdleDeadline.timeRemaining() renvoie le temps restant estimé en millisecondes sous la forme d’un DOMHighResTimeStamp non négatif, éventuellement fractionnaire. Une fois l’échéance atteinte, la méthode renvoie 0. Vérifiez cette valeur entre de petites unités de travail : l’échéance n’interrompt pas le code en cours d’exécution.

IdleDeadline.didTimeout est une propriété booléenne en lecture seule. true signifie que l’appel a eu lieu à la suite de l’expiration de l’option timeout ; dans ce cas, timeRemaining() renvoie 0. Le simple épuisement du budget ne fait pas passer didTimeout à true. timeout ne garantit pas un instant d’exécution précis.

L’exemple additionne des nombres par lots et reprogramme le travail inachevé. Le chemin didTimeout autorise une petite opération, pas une boucle sans limite. Le travail partage le thread principal de manière coopérative ; il ne s’exécute pas dans un thread séparé.

Exemples

(() => {
  if (typeof window.requestIdleCallback !== "function") {
    console.log("requestIdleCallback unavailable");
    return;
  }

  const values = [1, 2, 3, 4];
  let index = 0;
  let total = 0;

  function work(deadline) {
    let processed = 0;
    while (
      index < values.length &&
      (deadline.timeRemaining() > 1 ||
        (deadline.didTimeout && processed === 0))
    ) {
      total += values[index++];
      processed++;
    }

    if (index < values.length) {
      window.requestIdleCallback(work, { timeout: 1000 });
    } else {
      console.log(total);
    }
  }

  window.requestIdleCallback(work, { timeout: 1000 });
})();

Résultat

10

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