CKTIS / JavaScript
cancelIdleCallback() : annuler un rappel en attente
cancelIdleCallback(handle) annule un rappel en attente planifié par requestIdleCallback(). Il faut fournir l’identifiant de la requête, et non la fonction de rappel elle-même.
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.cancelIdleCallback(handle)window.cancelIdleCallback(handle) prend l’identifiant numérique renvoyé par requestIdleCallback() dans la même fenêtre. La méthode supprime le rappel en attente, même s’il est déjà prêt à être exécuté. Elle renvoie undefined.
Si l’identifiant ne correspond à aucune requête en attente, la méthode ne fait rien. Elle ne peut pas interrompre un rappel dont l’exécution a commencé ni annuler ses effets.
Il s’agit d’une API Web de Window, et non d’une fonction définie par ECMAScript. Vérifiez que les deux méthodes sont disponibles ; la présence de Node 24 dans un dépôt ne prouve pas la prise en charge par les navigateurs.
L’exemple annule la requête juste après sa planification, avant de rendre la main au navigateur. Conservez l’identifiant afin de pouvoir annuler le travail devenu inutile.
Exemples
(() => {
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");
})();Résultat
Cancellation requested
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.