Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / JavaScript

Animation.pause() — mettere in pausa un’animazione

Animation.pause() sospende la riproduzione di un’animazione senza annullarla. L’operazione può essere in sospeso; animation.ready permette di attenderne il completamento.

Versione: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Sintassi

animation.pause();

animation.pause() non accetta argomenti e restituisce undefined, non una promise. Sospende l’avanzamento del tempo dell’animazione; play() riprende la riproduzione, mentre cancel() la annulla.

La pausa può richiedere sincronizzazione. Usa await animation.ready invece di await animation.pause(). Osservare soltanto playState === 'paused' non dimostra che l’operazione sia terminata: pending può essere ancora true.

Questa è un’API browser di Web Animations, non una funzionalità ECMAScript. Non dedurre il supporto dalla versione di Node.js; controlla i browser di destinazione.

Esempi

(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();
})();

Risultato

paused
500
false

Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.

Fonti