This is an experimental technology
Because this technology's specification has not stabilized, check the compatibility table for usage in various browsers. Also note that the syntax and behavior of an experimental technology is subject to change in future versions of browsers as the specification changes.

The oncancel property of the Web Animations API's Animation interface is the event handler for the cancel event.

The cancel event can be triggered manually with Animation.cancel() when the animation enters the "idle" play state from another state, such as when the animation is removed from an element before it finishes playing

Creating a new animation that is initially idle does not trigger a cancel event on the new animation.


var cancelHandler = Animation.oncancel;

Animation.oncancel = cancelHandler;


A function to be executed when the animation is cancelled, or null if there is no cancel event handler.


If this animation is canceled, remove its element.

animation.oncancel =;


Specification Status Comment
Web Animations
The definition of 'Animation.oncancel' in that specification.
Working Draft Editor's draft.

Browser compatibility

Feature Chrome Firefox (Gecko) Internet Explorer Opera Safari (WebKit)
Basic support 39.0 48 (48)[1] No support No support No support
Feature Android Firefox Mobile (Gecko) IE Phone Opera Mobile Safari Mobile
Basic support (Yes) 48.0 (48)[1] No support No support No support

[1] The Web Animations API is only enabled by default in Firefox Developer Edition and Nightly builds. You can enable it in beta and release builds by setting the preference dom.animations-api.core.enabled to true, and can disable it in any Firefox version by setting this preference to false.

See also

Document Tags and Contributors

 Contributors to this page: Sheppy, birtles, chrisdavidmills, PushpitaPikuDey, rachelnabors
 Last updated by: Sheppy,