AnimationEffect.getComputedTiming()
Experimental: This is an experimental technology
Check the Browser compatibility table carefully before using this in production.
The getComputedTiming()
method of the AnimationEffect
interface returns the calculated timing properties for this animation effect.
Although many of the attributes of the returned object are common to the object returned by the AnimationEffect.getTiming()
method, the values returned by this object differ in the following ways:
duration
-
Returns the calculated value of the iteration duration. If
duration
is the stringauto
, this attribute will return0
. fill
-
The
auto
value is replaced with the appropriatefill
value.
Note: These values are comparable to the computed styles of an Element returned using window.getComputedStyle(elem)
.
Syntax
var currentTimeValues = animation.getComputedTiming();
Parameters
None.
Return Value
An object which contains the following properties:
- endTime
-
The end time of the animation in milliseconds from the animation's start (if the
KeyframeEffect
is associated with anAnimation
). (Also includesendDelay
in that calculation.) - activeDuration
-
The length of time in milliseconds that the animation's effects will run. This is equal to the iteration duration multiplied by the iteration count.
- localTime
-
The current time of the animation in milliseconds. If the
KeyframeEffect
is not associated with anAnimation
, its value isnull
. - progress
-
Indicates how far along the animation is through its current iteration with values between
0
and1
. Returnsnull
if the animation is not running or itsKeyframeEffect
isn't associated with anAnimation
. - currentIteration
-
The number of times this animation has looped, starting from
0
. Returnsnull
if the animation is not running or itsKeyframeEffect
isn't associated with anAnimation
.
Specifications
Specification |
---|
Web Animations # dom-animationeffect-getcomputedtiming |
Browser compatibility
BCD tables only load in the browser