CKTIS / JavaScript
Animation.finished — la promesse de fin de l’animation
Animation.finished permet d’attendre la fin d’une animation avec await, tout en tenant compte de son éventuelle annulation.
Version : ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntaxe
const completedAnimation = await animation.finished;Animation.finished est une propriété en lecture seule qui renvoie une Promise<Animation>. Lorsque l’animation atteint l’état finished, y compris avec finish(), la promesse peut être résolue avec l’objet représentant l’animation. Ce n’est ni une valeur booléenne ni une méthode.
Lorsque l’animation quitte l’état finished, la promesse actuelle n’est remplacée que si elle a déjà été résolue. Si l’animation quitte cet état avant que la notification de fin mise en file d’attente ne résolve la promesse, la même promesse peut rester en attente. Relisez la propriété pour une nouvelle lecture. Si l’animation n’est pas dans l’état idle, cancel() rejette sa promesse finished actuelle avec une DOMException nommée AbortError, à condition que la promesse soit encore en attente. Utilisez try/catch pour gérer ce rejet. Si l’animation est déjà dans l’état idle, cancel() laisse la promesse finished en attente si elle l’était déjà. L’exécution peut donc rester suspendue sur await sans passer par le bloc catch. ready indique que la lecture ou la pause est prête, et non que l’animation est terminée.
Cela relève de Web Animations, et non d’ECMAScript. La prise en charge par le navigateur est nécessaire ; la présence de Node 24 dans le dépôt ne la garantit pas.
Exemples
(async () => {
const element = document.createElement('div');
element.textContent = 'Animation.finished';
document.body.append(element);
const animation = element.animate(
[{ opacity: 0 }, { opacity: 1 }],
{ duration: 1000, fill: 'forwards' }
);
try {
const completion = animation.finished;
animation.finish();
const result = await completion;
console.log(result === animation);
console.log(animation.playState);
} catch (error) {
console.log(error.name);
} finally {
animation.cancel();
element.remove();
}
})();Résultat
true finished
Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.