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

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.

Sources