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

CKTIS / JavaScript

requestAnimationFrame — mises à jour avant le rendu

requestAnimationFrame demande un rappel exécuté une seule fois lors d’une mise à jour du rendu. Il permet d’animer en fonction du temps écoulé, sans supposer un nombre fixe d’images par seconde.

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

const handle = window.requestAnimationFrame((timestamp) => { /* update visual state */ });
window.cancelAnimationFrame(handle);

window.requestAnimationFrame(callback) enregistre un rappel exécuté une seule fois dans le cadre d’une mise à jour du rendu, avant l’affichage de l’image. La fonction renvoie un identifiant numérique de demande, et non le résultat du rappel. Pour continuer, il faut demander explicitement une autre image ; window.cancelAnimationFrame(handle) supprime un rappel en attente.

L’argument timestamp est un horodatage haute résolution, exprimé en millisecondes par rapport à l’origine temporelle de l’environnement ; ce n’est ni une date du calendrier ni la durée d’une image. Calculez le temps écoulé en soustrayant les horodatages. Les rappels invoqués dans le même lot pour la même cible reçoivent le même horodatage.

Ne partez pas du principe qu’il y aura 60 images par seconde ou un délai fixe. La fréquence dépend des occasions de rendu ; les documents invisibles peuvent ne recevoir aucune mise à jour. Gardez le rappel court, car un traitement prolongé retarde le rendu. Des changements de position fondés sur le temps évitent que la vitesse du mouvement dépende du nombre d’images.

Cette API fait partie de la norme HTML ; ce n’est pas une fonctionnalité d’une édition particulière d’ECMAScript. Les moteurs de navigateur actuels la prennent en charge pour Window ; la présence de Node 24 dans un dépôt ne prouve pas sa prise en charge. L’exemple nécessite une page visible où document.body existe. Il anime un point. Le dernier rappel fixe son décalage à 100 pixels, écrit done: 100px dans la console, puis supprime le point avant que le navigateur puisse l’afficher à cette position. La durée de mouvement prévue est de 1000 ms, mais la fin réelle peut survenir plus tard.

Exemples

(() => {
  const dot = document.createElement('div');
  dot.textContent = '●';
  document.body.append(dot);
  let start;

  function frame(timestamp) {
    if (start === undefined) start = timestamp;
    const progress = Math.min((timestamp - start) / 1000, 1);
    dot.style.transform = `translateX(${100 * progress}px)`;

    if (progress < 1) {
      window.requestAnimationFrame(frame);
    } else {
      console.log('done: 100px');
      dot.remove();
    }
  }

  window.requestAnimationFrame(frame);
})();

Résultat

done: 100px

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