This is an experimental technology
Check the Browser compatibility table carefully before using this in production.

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 = function() {; };


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

Browser compatibility

FeatureChromeEdgeFirefoxInternet ExplorerOperaSafari
Basic support50 ?


42 — 481

No37 No
FeatureAndroid webviewChrome for AndroidEdge mobileFirefox for AndroidOpera AndroidiOS SafariSamsung Internet
Basic support5050 ?


42 — 481

37 No5.0

1. From version 42 until version 48 (exclusive): this feature is behind the dom.animations-api.core.enabled preference (needs to be set to true). To change preferences in Firefox, visit about:config.

See also

Document Tags and Contributors

Last updated by: fscholz,