Element: getAnimations() method
Baseline
Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2020.
The getAnimations() method of the Element interface
(specified on the Animatable mixin) returns an array of all
Animation objects affecting this element or which are scheduled to do so
in future. It can optionally return Animation objects for descendant
elements too.
Note: This array includes CSS Animations, CSS Transitions, and Web Animations.
Syntax
getAnimations()
getAnimations(options)
Parameters
optionsOptional-
An options object containing the following property:
subtree-
A boolean value which, if
true, causes animations that target descendants of Element to be returned as well. This includes animations that target any CSS pseudo-elements attached to Element or one of its descendants. Defaults tofalse.
Return value
An Array of Animation objects, each representing an
animation currently targeting the Element on which this method is called,
or one of its descendant elements if { subtree: true } is specified.
Examples
The following code snippet will wait for all animations on elem and its
descendants to finish before removing the element from the document.
Promise.all(
elem.getAnimations({ subtree: true }).map((animation) => animation.finished),
).then(() => elem.remove());
Specifications
| Specification |
|---|
| Web Animations # dom-animatable-getanimations |
Browser compatibility
| desktop | mobile | |||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
getAnimations
|
|
|
|
|
|
|
|
|
|
|
|
|
Legend
Tip: you can click/tap on a cell for more information.
- Full support
- Full support
See also
- Web Animations API
- CSS Animations
- CSS Transitions
Document.getAnimations()- Fetch all animations in the documentAnimation