Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / JavaScript

requestAnimationFrame — aggiornamenti prima del rendering

requestAnimationFrame richiede una callback eseguita una sola volta durante un aggiornamento del rendering. Permette di animare in base al tempo trascorso, senza presupporre un numero fisso di fotogrammi al secondo.

Versione: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Sintassi

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

window.requestAnimationFrame(callback) registra una callback eseguita una sola volta nell’ambito di un aggiornamento del rendering, prima che l’immagine venga presentata. Restituisce un identificatore numerico della richiesta, non il risultato della callback. Per continuare, occorre richiedere esplicitamente un altro fotogramma; window.cancelAnimationFrame(handle) rimuove una callback in attesa.

L’argomento timestamp è un timestamp ad alta risoluzione espresso in millisecondi rispetto all’origine temporale dell’ambiente; non è una data di calendario né la durata di un fotogramma. Calcola il tempo trascorso sottraendo i timestamp. Le callback invocate nello stesso gruppo per lo stesso obiettivo ricevono lo stesso timestamp.

Non dare per scontati 60 fotogrammi al secondo né un ritardo fisso. La frequenza dipende dalle opportunità di rendering; i documenti non visibili potrebbero non ricevere aggiornamenti. Mantieni breve la callback, perché un’elaborazione prolungata ritarda il rendering. Le variazioni di posizione basate sul tempo impediscono che la velocità del movimento dipenda dal numero di fotogrammi.

Questa è un’API dello standard HTML, non una funzionalità di una particolare edizione di ECMAScript. I motori browser attuali la supportano per Window; la presenza di Node 24 in un repository non ne dimostra il supporto. L’esempio richiede una pagina visibile con document.body già esistente. Anima un punto: l’ultima callback imposta lo spostamento a 100 pixel, scrive done: 100px nella console e rimuove il punto prima che il browser possa visualizzarlo in quella posizione. La durata prevista del movimento è di 1000 ms, ma il completamento effettivo potrebbe avvenire più tardi.

Esempi

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

Risultato

done: 100px

Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.

Fonti