SVGAnimationElement: getSimpleDuration() method
Baseline
Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since January 2020.
The SVGAnimationElement method getSimpleDuration() returns a float representing the number of seconds for the simple duration for this animation.
Simple duration refers to the length of time an animation is supposed to run for a single iteration, without considering repeats, restarts, or extensions.
This property reflects the dur attribute of the <animate>, <animateMotion> or <animateTransform> element.
Syntax
getSimpleDuration()
Parameters
None (undefined).
Return value
A float.
Exceptions
NotSupportedErrorDOMException-
Thrown if the
SVGAnimationElement's simple duration is undefined (e.g., the end time is indefinite). This happens when thedurattribute is set toindefiniteor is undefined, as then the simple duration is considered undefined.
Examples
This example demonstrates how the dur="3s" attribute defines a simple duration of 3 seconds.
<svg width="200" height="200" viewBox="0 0 200 200">
<circle cx="50" cy="50" r="20" fill="rebeccapurple">
<animate
attributeName="cx"
from="50"
to="150"
dur="3s"
repeatCount="indefinite" />
</circle>
</svg>
const animationElement = document.querySelector("animate");
const simpleDuration = animationElement.getSimpleDuration();
console.log(`The simple duration is: ${simpleDuration} seconds`); // Output: 3
Since repeatCount="indefinite" specifies continuous looping, the effective duration is infinite, but the simple duration remains 3 seconds per iteration.
Specifications
| Specification |
|---|
| SVG Animations Level 2 # __svg__SVGAnimationElement__getSimpleDuration |
Browser compatibility
| desktop | mobile | |||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
getSimpleDuration
|
|
|
|
|
|
|
|
|
|
|
|
|
Legend
Tip: you can click/tap on a cell for more information.
- Full support
- Full support