Animation: ready property

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.

The read-only Animation.ready property of the Web Animations API returns a Promise which resolves when the animation is ready to play. A new promise is created every time the animation enters the "pending" play state as well as when the animation is canceled, since in both of those scenarios, the animation is ready to be started again.

Note: Since the same Promise is used for both pending play and pending pause requests, authors are advised to check the state of the animation when the promise is resolved.

Value

A Promise which resolves when the animation is ready to be played. You'll typically use a construct similar to this when using the ready promise:

js
animation.ready.then(() => {
  // Do whatever needs to be done when
  // the animation is ready to run
});

Examples

In the following example, the state of the animation will be running when the current ready Promise is resolved because the animation does not leave the pending play state in between the calls to pause and play and hence the current ready Promise does not change.

js
animation.pause();
animation.ready.then(() => {
  // Displays 'running'
  alert(animation.playState);
});
animation.play();

Specifications

Specification
Web Animations
# dom-animation-ready

Browser compatibility

Report problems with this compatibility data on GitHub
desktopmobile
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
ready

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support

See also