CKTIS / JavaScript
Animation.cancel(): cancelar una animación
Animation.cancel() interrumpe una animación y elimina su efecto en el elemento, en lugar de mantenerla en el fotograma actual.
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.cancel();animation.cancel() es un método de Web Animations, no del propio ECMAScript. No acepta argumentos y devuelve undefined. Establece playState en idle, y currentTime y startTime en null.
Elimina el efecto de la animación, también con fill: 'both'; no guarda un fotograma en los estilos. A diferencia de pause(), no conserva la posición actual; a diferencia de finish(), no avanza hasta el final. El objeto se puede volver a iniciar con play().
Si la animación no está en estado idle, el método sustituye la promesa finished existente por otra y pone en cola un evento cancel. La promesa anterior se rechaza con AbortError solo si aún está pendiente. Si ya se cumplió, permanece cumplida. Añade la gestión del rechazo antes de cancelar. El ejemplo requiere un navegador; Node 24 no demuestra que esta API sea compatible.
Ejemplos
(async () => {
const box = document.createElement('div');
document.body.append(box);
const animation = box.animate(
[{ opacity: 0 }, { opacity: 1 }],
{ duration: 1000, fill: 'both' }
);
const outcome = animation.finished.catch(error => error.name);
animation.cancel();
console.log(animation.playState);
console.log(animation.currentTime === null);
console.log(animation.startTime === null);
console.log(await outcome);
box.remove();
})();Resultado
idle true true AbortError
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.