AnimationEffectReadOnly.getComputedTiming

The getComputedTiming() method of the AnimationEffectReadOnly interface returns the calculated timing properties for this animation effect.

Although many of the attributes of the returned object are common to the AnimationEffectTimingReadOnly contained in the object returned by the AnimationEffectReadOnly.timing attribute, the values returned by this object differ in the following ways:

duration

Returns the calculated value of the iteration duration. If AnimationEffectTimingReadOnly.duration is the string auto, this attribute will return 0.

fill

The auto value is replaced with the appropriate AnimationEffectTimingReadOnly.fill value.

Syntax

var currentTimeValues = animation.getComputedTiming();

Parameters

None.

Return Value

A ComputedTimingProperties dictionary 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 AnimationEffectTimingReadOnly.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	Status	Comment
Web Animations The definition of 'AnimationEffectReadOnly.getComputedTiming()' in that specification.	Working Draft	Editor's draft.

Browser compatibility

See also

• Web Animations API
• AnimationEffectReadOnly
• Animation
• KeyFrameEffect