CKTIS / JavaScript
Animation.pause() — mettre une animation en pause
Animation.pause() suspend la lecture d’une animation sans l’annuler. L’opération peut être en attente ; animation.ready permet d’attendre qu’elle se termine.
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.pause();animation.pause() ne prend aucun argument et renvoie undefined, pas une promesse. Cette méthode suspend l’avancement du temps de l’animation ; play() reprend la lecture, tandis que cancel() l’annule.
La mise en pause peut nécessiter une synchronisation. Utilisez await animation.ready plutôt que await animation.pause(). Le simple fait d’observer playState === 'paused' ne prouve pas que l’opération est terminée : pending peut encore valoir true.
Il s’agit d’une API de navigateur Web Animations, et non d’une fonctionnalité ECMAScript. Ne déduisez pas sa prise en charge de la version de Node.js ; vérifiez les navigateurs ciblés.
Exemples
(async () => {
const box = document.createElement('div');
box.textContent = 'Pause demo';
document.body.append(box);
const animation = box.animate(
[{ opacity: 0 }, { opacity: 1 }],
{ duration: 1000, fill: 'both' }
);
animation.pause();
await animation.ready;
animation.currentTime = 500;
console.log(animation.playState);
console.log(animation.currentTime);
console.log(animation.pending);
animation.cancel();
box.remove();
})();Résultat
paused 500 false
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.