MDN wants to talk to developers like you: https://qsurvey.mozilla.com/s3/8d22564490d8

window.requestIdleCallback()

Cette traduction est incomplète. Aidez à traduire cet article depuis l'anglais.

Cette fonction est expérimentale
Puisque cette fonction est toujours en développement dans certains navigateurs, veuillez consulter le tableau de compatibilité pour les préfixes à utiliser selon les navigateurs.
Il convient de noter qu'une fonctionnalité expérimentale peut voir sa syntaxe ou son comportement modifié dans le futur en fonction des évolutions de la spécification.

Résumé

La méthode window.requestIdleCallback() mémorise une fonction qui sera appellée lorsque le navigateur n'aura plus aucune autre tâche en cours. Cela offre au développeur la possibilité de réaliser des tâches à basse priorité en arrière-plan sur le thread principal, sans impacter l'expérience utilisateur (ralentissement des animations, etc). L'ordre des appels aux fonctions est généralement premier entré, premier sorti, sauf si le timeout défini au moment de l'enregistrement est atteint avant que le navigateur n'ait eu le temps d'appeler la fonction en question.

Syntaxe

var idleCallbackId = window.requestIdleCallback(fonction[, options])

Retour de l'appel

Un entier long non-signé qui peut être utilisé pour annulé l'appel à la fonction via la méthode window.cancelIdleCallback().

Paramètres

fonction
La référence d'une fonction qui devrait être appellée dans un futur proche. La fonction en question recevra en argument un objet de type temps restant avec les propriétés suivantes :
  • timeRemaining : Fonction qui retourne un DOMHighResTimeStamp repésentant le temps restant estimé par le navigateur pour exécuter la tâche, ayant pour valeur minimale zéro. Les tâches nécessitant un temps d'exécution relativement long sont susceptibles de recourir à plusieurs appels à cette méthode s'il reste du travail à effectuer, rendant la main au navigateur peu avant que le compteur n'atteigne zéro. timeRemaining() retournera toujours zéro si didTimeout est positionné à true (i.e. la fonction n'a pas été appelée durant la période de repos du navigateur). La limite de temps est limitée à 50ms, même si le navigateur reste n'a pas d'autre tâche à exécuter pendant une durée plus longue.
  • didTimeout : Un booléen positionné à true si la fonction est appelée car le timeout a été atteint, et false si elle a été appelée par le navigateur durant une période de repos.
options Facultatif
Objet contenant des paramètres de configuration optionnels. Les propriétés sont les suivantes :
  • timeout : Si timeout est spécifié et possède une valeur positive, la fonction sera appelée au bout de au moins timeout millisecondes si elle n'a pas été appelée par le navigateur au préalable.

Spécifications

Spécification Status Comment
Cooperative Scheduling of Background Tasks Version de travail Définition initiale.

Compatibilité avec les navigateurs

Feature Chrome Firefox (Gecko) Internet Explorer Opera Safari (WebKit)
Basic support 47 Pas de support[1] Pas de support 34 Pas de support
Feature Android Android Webview Firefox Mobile (Gecko) Firefox OS IE Mobile Opera Mobile Safari Mobile Chrome for Android
Basic support Pas de support 47 ? ? ? ? ? 47

[1] En voie d'être déployé dans Firefox 52, voir le bug 1198381.

Étiquettes et contributeurs liés au document

 Contributeurs à cette page : Adrael
 Dernière mise à jour par : Adrael,