--- title: Animation.cancel() slug: Web/API/Animation/cancel tags: - API - Animacion - Animaciones Web - Experimental - Reference - cancel - metodo - waapi translation_of: Web/API/Animation/cancel ---

{{ SeeCompatTable() }}{{ APIRef("Web Animations") }}

El método cancel() de la Web Animations API de la interfaz {{domxref("Animation")}} borra todos los {{domxref("KeyframeEffect")}} causados por esta animación y aborta su reproducción.

Cuando se cancela una animación, su {{domxref("Animation.startTime", "startTime")}} y su {{domxref("Animation.currentTime", "currentTime")}} se establecen en  null.

Sintaxis

Animation.cancel();

Parámetros

None.

Valor devuelto

None.

Excepciones

Este método no arroja excepciones directamente; sin embargo, si la animación {{domxref ("Animation.playState", "playState")}} no está "idle""inactiva" cuando se cancela, el {{domxref ("Animation.finished", "current finished promise", "", 1)}} se rechaza con un {{domxref ("DOMException")}} llamado AbortError.

Especificaciones

Specification Status Comment
{{SpecName('Web Animations', '#dom-animation-cancel', 'Animation.cancel()' )}} {{Spec2('Web Animations')}} Editor's draft.

Compatibilidad del navegador

{{CompatibilityTable}}
Feature Chrome Firefox (Gecko) Internet Explorer Opera Safari (WebKit)
Basic support {{CompatChrome(39.0)}} {{CompatGeckoDesktop(48)}}[1] {{CompatNo}} {{CompatNo}} {{CompatNo}}
Feature Android Firefox Mobile (Gecko) IE Phone Opera Mobile Safari Mobile
Basic support {{CompatVersionUnknown}} {{CompatGeckoMobile(48)}}[1] {{CompatNo}} {{CompatNo}} {{CompatNo}}

[1] La Web Animations API solo está habilitada por defecto en Firefox Developer Edition y Nightly builds. Puedes habilitarlo en versiones Beta y de lanzamiento estableciendo la preferencia dom.animations-api.core.enabled en true, y puedes deshabilitarlo en cualquier versión de Firefox estableciendo esta propiedad en false.

Ver también