Web/API/AnimationEvent/AnimationEvent

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

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

Syntax

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

Parameters

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

type: 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 itself, specify an empty string: "". It defaults to "".

Return value

A new AnimationEvent, initialized per any provided options.

Specifications

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

Browser compatibility

Update compatibility data on GitHub

	Desktop						Mobile
	Chrome	Edge	Firefox	Internet Explorer	Opera	Safari	Android webview	Chrome for Android	Firefox for Android	Opera for Android	Safari on iOS	Samsung Internet
`AnimationEvent()` constructor Experimental'	Chrome Full support 43	Edge Full support 14	Firefox Full support 23	IE No support No	Opera No support No	Safari No support No	WebView Android Full support 43	Chrome Android Full support 43	Firefox Android Full support 23	Opera Android No support No	Safari iOS ?	Samsung Internet Android Full support 4.0

Legend

Full support: Full support
No support: No support
Compatibility unknown: Compatibility unknown
Experimental. Expect behavior to change in the future.': Experimental. Expect behavior to change in the future.