This is an experimental technology
Because this technology's specification has not stabilized, check the compatibility table for the proper prefixes to use 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 spec changes.

The AnimationEvent() constructor returns a newly created AnimationEvent, representing an event in relation with an animation.


animationEvent = new AnimationEvent(type, {animationName: aPropertyName, 
                                           elapsedTime  : aFloat, 
                                           pseudoElement: aPseudoElementName});


The AnimationEvent() constructor also inherits arguments from Event().

A DOMString representing the name of the type of the AnimationEvent. It is case-sensitive and can be: 'animationstart', 'animationend', or 'animationiteration'.
animationName Optional
A DOMString containing the value of the animation-name CSS property associated with the transition. It defaults to "".
elapsedTime Optional
A float giving the amount of time the animation has been running, in seconds, when this event fired, excluding any time the animation was paused. For an "animationstart" event, elapsedTime is 0.0 unless there was a negative value for animation-delay, in which case the event will be fired with elapsedTime containing  (-1 * delay). It defaults to 0.0.
pseudoElement Optional
Is a DOMString, starting with "::", containing the name of the pseudo-element the animation runs on. If the animation doesn't run on a pseudo-element but on the element, an empty string: "". It defaults to ""


Specification Status Comment
CSS Animations
The definition of 'AnimationEvent()' in that specification.
Working Draft Initial definition.

Browser compatibility

Feature Chrome Firefox (Gecko) Internet Explorer Opera Safari
Basic support 43.0 23.0 (23.0) Not supported Not supported Not supported
pseudoElement Not supported 23.0 (23.0) Not supported Not supported Not supported
Feature Android Firefox Mobile (Gecko) IE Mobile Opera Mobile Safari Mobile Chrome for Android
Basic support Not supported 23.0 (23.0) Not supported Not supported Not supported 43.0
pseudoElement Not supported 23.0 (23.0) Not supported Not supported Not supported Not supported

See also

Document Tags and Contributors

Contributors to this page: teoli, jpmedley, fscholz, Sheppy, tregagnon
Last updated by: teoli,