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

CKTIS / JavaScript

Animation.finished — la promesa de finalización de la animación

Animation.finished permite esperar con await a que termine una animación y tener en cuenta si se cancela.

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 completedAnimation = await animation.finished;

Animation.finished es una propiedad de solo lectura que devuelve un Promise<Animation>. Cuando la animación alcanza el estado finished, incluso mediante finish(), la promesa puede cumplirse con el objeto de la animación. No es ni un valor booleano ni un método.

Al salir del estado finished, la promesa actual solo se sustituye si ya se ha cumplido. Si la animación sale de ese estado antes de que la notificación de finalización puesta en cola resuelva la promesa, la misma promesa puede seguir pendiente. Vuelve a leer la propiedad para otra reproducción. Si la animación no está en el estado idle, cancel() rechaza su promesa finished actual con una DOMException llamada AbortError, siempre que la promesa siga pendiente. Usa try/catch para gestionar ese rechazo. Si la animación ya está en el estado idle, cancel() no rechaza la promesa finished pendiente: la ejecución puede seguir suspendida en await sin entrar en el bloque catch. ready indica que la reproducción o la pausa está lista, no que la animación haya terminado.

Esto forma parte de Web Animations, no de ECMAScript. Se necesita compatibilidad del navegador; la presencia de Node 24 en el repositorio no la demuestra.

Ejemplos

(async () => {
  const element = document.createElement('div');
  element.textContent = 'Animation.finished';
  document.body.append(element);

  const animation = element.animate(
    [{ opacity: 0 }, { opacity: 1 }],
    { duration: 1000, fill: 'forwards' }
  );

  try {
    const completion = animation.finished;
    animation.finish();
    const result = await completion;
    console.log(result === animation);
    console.log(animation.playState);
  } catch (error) {
    console.log(error.name);
  } finally {
    animation.cancel();
    element.remove();
  }
})();

Resultado

true
finished

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