ThegetAnimations() method of theElement interface(specified on theAnimatable mixin) returns an array of allAnimation objects affecting this element or which are scheduled to do soin future. It can optionally returnAnimation objects for descendantelements too.

Syntax

getAnimations()getAnimations(options)

Parameters

optionsOptional

An options object containing the following property:

subtree

A boolean value which, iftrue, causes animations that targetdescendants ofElement to be returned as well. This includes animationsthat target any CSSpseudo-elements attached toElement or one of its descendants. Defaults tofalse.

Return value

AnArray ofAnimation objects, each representing ananimation currently targeting theElement 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 onelem and itsdescendants to finish before removing the element from the document.

Promise.all(  elem.getAnimations({ subtree: true }).map((animation) => animation.finished),).then(() => elem.remove());

Specifications

Browser compatibility

See also

• Web Animations API
• CSS Animations
• CSS Transitions
• Document.getAnimations() - Fetch all animations in the document
• Animation