Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

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.

Sources