AnimationEffect: getComputedTiming() method

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since March 2020.

Learn more
See full compatibility

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

Note: These values are comparable to the computed styles of an Element returned using window.getComputedStyle(elem).

Syntax

getComputedTiming()

Parameters

None.

Return value

An object which contains:

all of the properties of the object returned by AnimationEffect.getTiming(), except that any "auto" values are replaced by computed values that may depend on the type of AnimationEffect.
the following additional properties:

endTime

A number indicating the end time of the effect in milliseconds from the effect's start. This is equal to activeDuration plus delay and endDelay.

activeDuration

A number indicating the total duration in milliseconds of all iterations of the effect. This is equal to duration multiplied by iterations (or zero if that product would be NaN).

localTime

A number or null.

Indicates the length of time in milliseconds that the effect has run. This is equal to the currentTime of the associated animation, or null if the effect is not associated with an animation.

progress

null or a number.

Indicates the effect's progress through its current iteration. At the start of the activeDuration, this equals the fractional part of iterationStart.

The value is typically between 0 and 1, but may fall outside this range depending on the effect's <easing-function>'s output. For example, an easing function of cubic-bezier(0.3, 2, 0.6, 2) would transform the time progress of 0.5 to approximately 1.65.

Returns null if the effect isn't mid-iteration, for example because the effect is in the delay or endDelay periods, the effect is finished, or localTime is null.

currentIteration

null or an integer number.

Indicates the index of the current iteration. At the start of the activeDuration, this equals the integer part of iterationStart.

Returns null whenever progress is null.