База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / JavaScript

IdleDeadline — времеви бюджет на callback при бездействие

IdleDeadline е обектът, който се предава на callback на requestIdleCallback(). Той предоставя оценка за оставащото време и показва дали callback-ът е изпълнен поради изтичане на времевото ограничение.

Версия: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Синтаксис

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

IdleDeadline е интерфейс от Web API, достъпен в Window, а не част от ECMAScript. Браузърът го подава на callback на requestIdleCallback(); не го създавайте с new IdleDeadline(). Проверете дали API е наличен; Node 24 не доказва поддръжка в браузър.

IdleDeadline.timeRemaining() връща оценката за оставащото време в милисекунди като неотрицателен DOMHighResTimeStamp, който може да е дробен. След достигане на крайния срок връща 0. Проверявайте стойността между малки единици работа: крайният срок не прекъсва код, който вече се изпълнява.

IdleDeadline.didTimeout е булево свойство само за четене. true означава, че извикването е станало поради изтичане на опцията timeout; в този случай timeRemaining() връща 0. Самото изчерпване на бюджета не променя didTimeout на true. timeout не гарантира точен момент на изпълнение.

Примерът събира числа на части и насрочва отново незавършената работа. Пътят didTimeout позволява една малка операция, а не неограничен цикъл. Работата споделя кооперативно главната нишка; не се изпълнява в отделна нишка.

Примери

(() => {
  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 });
})();

Резултат

10

Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.

Източници