Animation.ready
Baseline
Ampliamente disponible
Esta característica está consolidada y funciona en muchos dispositivos y versiones de navegador. Está disponible en todos los navegadores desde julio de 2020.
La propiedad de solo-lectura Animation.ready de la Web Animations API devuelve un Promise que se resuelve cuando la animación está lista para reproducirse. Una nueva 'promesa' es creada cada vez que la animación entra en play state(estado de reproducción) "pending"(pendiente) así como si la reproducción es cancelada, ya que en ambos escenarios, la animación estará lista para ser reiniciada.
Nota:
Dado que la misma Promise es usada para las solicitudes pendientes de play y pause , se recomienda a los autores que comprueben el estado de la animación cuando se resuelva la promesa.
Sintaxis
var readyPromise = Animation.ready;
Valor
Un Promise que se resuelve cuando la animación esta lista para reproducirse. Por lo general, se usará una construcción similar a esta usando una promise lista:
animation.ready.then(function () {
// Hace lo que sea necesario cuando
// la animación está lista para reproducirse
});
Ejemplo
En el siguiente ejemplo, el estado de la animación será running(reproduciendo) cuando la Promise actual se resuelva ya que la animación no deja el estado de reproducción pending entre las llamadas pause and play ,por lo tanto, la Promise actual no cambia.
animation.pause();
animation.ready.then(function () {
// Displays 'running'
alert(animation.playState);
});
animation.play();
Especificaciones
| Especificación |
|---|
| Web Animations # dom-animation-ready |