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

CKTIS / JavaScript

cancelIdleCallback(): отмяна на чакащо обратно извикване

cancelIdleCallback(handle) отменя чакащо обратно извикване, планирано с requestIdleCallback(). Необходим е идентификаторът на заявката, а не самата функция за обратно извикване.

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

Синтаксис

window.cancelIdleCallback(handle)

window.cancelIdleCallback(handle) приема числовия идентификатор, върнат от requestIdleCallback() в същия прозорец. Методът премахва чакащото обратно извикване, дори ако то вече е готово за изпълнение. Връща undefined.

Ако идентификаторът не съответства на чакаща заявка, методът не прави нищо. Той не може да прекъсне обратно извикване, чието изпълнение вече е започнало, нито да отмени последиците му.

Това е Web API на Window, а не функция, дефинирана от ECMAScript. Проверете дали и двата метода са налични; наличието на Node 24 в хранилище не доказва поддръжка от браузърите.

Примерът отменя заявката веднага след планирането ѝ, преди да предаде управлението на браузъра. Запазете идентификатора, за да можете да отмените работа, която вече не е необходима.

Примери

(() => {
  if (typeof window === "undefined" ||
      typeof window.requestIdleCallback !== "function" ||
      typeof window.cancelIdleCallback !== "function") {
    console.log("Idle callbacks unavailable");
    return;
  }

  const handle = window.requestIdleCallback(() => {
    console.log("Unexpected callback");
  });
  window.cancelIdleCallback(handle);
  console.log("Cancellation requested");
})();

Резултат

Cancellation requested

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

Източници