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

CKTIS / JavaScript

Animation.play() : démarrer et reprendre des animations

Animation.play() démarre ou reprend une animation existante. Cette méthode ne crée pas une autre animation et ne renvoie pas de promesse.

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

animation.play()

animation.play() ne prend aucun argument et renvoie undefined. Pour une animation qui utilise la chronologie du document (document.timeline), comme dans l’exemple, play() conserve la position actuelle si la vitesse de lecture effective est positive et si le temps courant est positif ou nul et précède la fin de l’effet. À cette vitesse, si le temps courant atteint ou dépasse la fin de l’effet, play() ramène l’animation au début, même si elle est en pause.

Après un appel à updatePlaybackRate(), la vitesse de lecture effective utilisée par play() peut différer de playbackRate : si un changement de vitesse est en attente, play() utilise la valeur en attente. Sur la chronologie du document, une valeur négative en attente peut donc amener play() à faire passer le temps courant de zéro à la fin d’un effet de durée finie, alors même que playbackRate indique encore une valeur positive.

Le démarrage de la lecture peut attendre une tâche asynchrone. animation.ready signale que l’animation est prête, tandis que animation.finished signale qu’elle est terminée. L’appel de play() lui-même n’attend ni l’un ni l’autre.

Il s’agit d’une API Web, et non d’une fonctionnalité ECMAScript. Vérifiez sa prise en charge dans le navigateur cible ; Node 24 ne permet pas de l’établir. L’exemple montre une reprise à partir d’une position comprise dans la plage temporelle de l’effet, et non le cas d’une vitesse négative en attente. Il utilise un effet sans élément cible et n’affiche rien.

Exemples

const effect = new KeyframeEffect(null, [], { duration: 1000 });
const animation = new Animation(effect, document.timeline);

animation.currentTime = 400;
const result = animation.play();
console.log(result === undefined, animation.currentTime);

animation.finish();
console.log(animation.playState, animation.currentTime);

Résultat

true 400
finished 1000

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