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

CKTIS / JavaScript

Animation.play(): iniciar y reanudar animaciones

Animation.play() inicia o reanuda una animación existente. No crea otra animación ni devuelve una promesa.

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.play()

animation.play() no acepta argumentos y devuelve undefined. En una animación que utiliza la línea de tiempo del documento (document.timeline), como en el ejemplo, play() conserva la posición actual si la velocidad efectiva de reproducción es positiva y el tiempo actual no es negativo ni ha llegado al final del efecto. A esa velocidad, si el tiempo actual alcanza o supera el final del efecto, play() devuelve la animación al principio, incluso si está en pausa.

Tras llamar a updatePlaybackRate(), la velocidad efectiva de reproducción que usa play() puede diferir de playbackRate: si hay un cambio de velocidad pendiente, play() usa el valor pendiente. Por eso, en la línea de tiempo del documento, un valor negativo pendiente puede hacer que play() salte del tiempo cero al final de un efecto de duración finita, aunque playbackRate todavía indique un valor positivo.

El inicio de la reproducción puede esperar a una tarea asíncrona. animation.ready indica que está lista, mientras que animation.finished indica que ha terminado. La llamada a play() en sí no espera a ninguna de las dos.

Es una API web, no una característica de ECMAScript. Comprueba la compatibilidad en el navegador de destino; Node 24 no la demuestra. El ejemplo muestra cómo se reanuda la animación desde una posición dentro del intervalo temporal del efecto, no el caso de una velocidad negativa pendiente. Usa un efecto sin elemento de destino y no dibuja nada.

Ejemplos

const effect = new KeyframeEffect(null, [], { duration: 1000 });
const animation = new Animation(effect, document.timeline);

animation.currentTime = 400;
const result = animation.play();
console.log(result === undefined, animation.currentTime);

animation.finish();
console.log(animation.playState, animation.currentTime);

Resultado

true 400
finished 1000

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