Animation: Animation() constructor

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since ⁨March 2020⁩.

TheAnimation() constructor of theWeb Animations API returns a newAnimation object instance.

Syntax

new Animation()new Animation(effect)new Animation(effect, timeline)

Parameters

effectOptional: The target effect, as an object based on theAnimationEffect interface, to assign to the animation. Although in the future other effects such asSequenceEffects orGroupEffects might be possible, the only kind of effect currently available isKeyframeEffect. This can benull (which is the default) to indicate that there should be no effect applied.
timelineOptional: Specifies thetimeline with which to associate the animation, as an object of a type based on theAnimationTimeline interface. The default value isDocument.timeline, but this can be set tonull as well.

Examples

In theFollow the White Rabbit example, we can use theAnimation() constructor to create anAnimation for therabbitDownKeyframes using the document'stimeline:

const whiteRabbit = document.getElementById("rabbit");const rabbitDownKeyframes = new KeyframeEffect(  whiteRabbit,  [{ transform: "translateY(0%)" }, { transform: "translateY(100%)" }],  { duration: 3000, fill: "forwards" },);const rabbitDownAnimation = new Animation(rabbitDownKeyframes);