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

CKTIS / JavaScript

Animation.pause() — pausar una animación

Animation.pause() suspende la reproducción de una animación sin cancelarla. La operación puede quedar pendiente; animation.ready permite esperar a que termine.

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

animation.pause();

animation.pause() no acepta argumentos y devuelve undefined, no una promesa. Suspende el avance del tiempo de la animación; play() reanuda la reproducción, mientras que cancel() la cancela.

Pausar puede requerir sincronización. Usa await animation.ready en lugar de await animation.pause(). Observar únicamente playState === 'paused' no demuestra que la operación haya terminado: pending aún puede ser true.

Esta es una API de navegador de Web Animations, no una función de ECMAScript. No deduzcas su compatibilidad a partir de la versión de Node.js; comprueba los navegadores de destino.

Ejemplos

(async () => {
  const box = document.createElement('div');
  box.textContent = 'Pause demo';
  document.body.append(box);

  const animation = box.animate(
    [{ opacity: 0 }, { opacity: 1 }],
    { duration: 1000, fill: 'both' }
  );
  animation.pause();
  await animation.ready;
  animation.currentTime = 500;

  console.log(animation.playState);
  console.log(animation.currentTime);
  console.log(animation.pending);

  animation.cancel();
  box.remove();
})();

Resultado

paused
500
false

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