AnimationEffect: getComputedTiming() method

Baseline 2022

Newly available

Since September 2022, this feature works across the latest devices and browser versions. This feature might not work in older devices or browsers.

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

js
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 at least 0 and less than 1.

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

    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.

Specifications

Specification
Web Animations
# dom-animationeffect-getcomputedtiming

Browser compatibility

BCD tables only load in the browser

See also