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 string auto, this attribute will return 0.

fill

The auto value is replaced with the appropriate fill 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 an Animation). (Also includes endDelay 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 an Animation, its value is null.

progress

Indicates how far along the animation is through its current iteration with values between 0 and 1. Returns null if the animation is not running or its KeyframeEffect isn't associated with an Animation.

currentIteration

The number of times this animation has looped, starting from 0. Returns null if the animation is not running or its KeyframeEffect isn't associated with an Animation.

Specifications

Specification
Web Animations Level 2 (Web Animations 2)
# dom-animationeffect-getcomputedtiming

Browser compatibility

BCD tables only load in the browser

See also