AnimationEffect.getComputedTiming()

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 EffectTiming contained in 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 EffectTiming.duration is the string auto, this attribute will return 0.
fill
The auto value is replaced with the appropriate EffectTiming.fill value.

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

A ComputedEffectTiming 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 EffectTiming.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 'AnimationEffect.getComputedTiming()' in that specification.
Working Draft Editor's draft.

Browser compatibility

Update compatibility data on GitHub
DesktopMobile
ChromeEdgeFirefoxInternet ExplorerOperaSafariAndroid webviewChrome for AndroidEdge MobileFirefox for AndroidOpera for AndroidSafari on iOSSamsung Internet
Basic supportChrome ? Edge ? Firefox Full support 63IE ? Opera ? Safari ? WebView Android ? Chrome Android ? Edge Mobile ? Firefox Android Full support 63Opera Android ? Safari iOS ? Samsung Internet Android ?

Legend

Full support  
Full support
Compatibility unknown  
Compatibility unknown

See also

Document Tags and Contributors

Contributors to this page: fscholz, birtles, rachelnabors, chrisdavidmills
Last updated by: fscholz,