Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / JavaScript

requestAnimationFrame — actualizaciones antes del renderizado

requestAnimationFrame solicita una función de retorno de llamada que se ejecuta una sola vez durante una actualización del renderizado. Permite animar según el tiempo transcurrido, en lugar de dar por sentada una cantidad fija de fotogramas por segundo.

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

Sintaxis

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

window.requestAnimationFrame(callback) registra una función de retorno de llamada que se ejecuta una sola vez como parte de una actualización del renderizado, antes de presentar la imagen. Devuelve un identificador numérico de solicitud, no el resultado de la función. Para continuar, hay que solicitar otro fotograma explícitamente; window.cancelAnimationFrame(handle) elimina una función de retorno de llamada pendiente.

El argumento timestamp es una marca de tiempo de alta resolución en milisegundos, relativa al origen temporal del entorno; no es una fecha del calendario ni la duración de un fotograma. Calcula el tiempo transcurrido restando marcas de tiempo. Las funciones de retorno de llamada invocadas en el mismo lote para el mismo objetivo reciben la misma marca de tiempo.

No des por sentados 60 fotogramas por segundo ni un retraso fijo. La frecuencia depende de las oportunidades de renderizado; es posible que los documentos invisibles no reciban actualizaciones. Mantén breve la función de retorno de llamada, porque el trabajo prolongado retrasa el renderizado. Los cambios de posición basados en el tiempo evitan que la velocidad del movimiento dependa del número de fotogramas.

Esta es una API del estándar HTML, no una característica de una edición concreta de ECMAScript. Los motores actuales de los navegadores la admiten para Window; que Node 24 esté presente en un repositorio no demuestra que sea compatible. El ejemplo requiere una página visible con document.body ya existente. Anima un punto y, en la última ejecución de la función de retorno de llamada, fija su desplazamiento en 100 píxeles, escribe done: 100px en la consola y elimina el punto antes de que el navegador pueda dibujarlo en esa posición. La duración prevista del movimiento es de 1000 ms, pero puede terminar más tarde.

Ejemplos

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

Resultado

done: 100px

El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.

Fuentes