This is an experimental technology
Check the Browser compatibility table carefully before using this in production.
The Animation
.finished
read-only property of the Web Animations API returns a Promise
which resolves once the animation has finished playing.
Every time the animation leaves the finished
play state (that is, when it starts playing again), a new Promise
is created for this property. The new Promise
will resolve once the new animation sequence has completed.
Syntax
var animationsPromise = Animation.finished;
Value
A Promise
object which will resolve once the animation has finished running.
Examples
The following code waits until all animations running on the element elem
have finished, then deletes the element from the DOM tree:
Promise.all( elem.getAnimations().map( function(animation) { return animation.finished } ) ).then( function() { return elem.remove(); } );
Specifications
Specification | Status | Comment |
---|---|---|
Web Animations The definition of 'Animation.finished' in that specification. |
Working Draft | Editor's draft. |
Browser compatibility
The compatibility table on this page is generated from structured data. If you'd like to contribute to the data, please check out https://github.com/mdn/browser-compat-data and send us a pull request.
Desktop | Mobile | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
finished | Chrome No support No | Edge No support No | Firefox
Full support
63
| IE No support No | Opera No support No | Safari No support No | WebView Android No support No | Chrome Android No support No | Firefox Android
Full support
63
| Opera Android No support No | Safari iOS No support No | Samsung Internet Android No support No |
Legend
- Full support
- Full support
- No support
- No support
- Experimental. Expect behavior to change in the future.
- Experimental. Expect behavior to change in the future.
- User must explicitly enable this feature.
- User must explicitly enable this feature.