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.
TheSVGAnimationElement methodgetSimpleDuration() 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 thedur attribute of the<animate>,<animateMotion> or<animateTransform> element.
In this article
Syntax
getSimpleDuration()Parameters
None (undefined).
Return value
A float.
Exceptions
NotSupportedErrorDOMExceptionThrown 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 thedur="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: 3SincerepeatCount="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> |