AnimationEffectReadOnly.getComputedTiming()

This is an experimental technology
Because this technology's specification has not stabilized, check the compatibility table for usage in various browsers. Also note that the syntax and behavior of an experimental technology is subject to change in future versions of browsers as the specification changes.

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.

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 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

Feature Chrome Firefox (Gecko) Internet Explorer Opera Safari (WebKit)
Basic support No support No support No support No support No support
Feature Android Android Webview Chrome for Android Firefox Mobile (Gecko) Firefox OS IE Mobile Opera Mobile Safari Mobile
Basic support No support No support No support No support No support No support No support No support

 

See also

Document Tags and Contributors

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