Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / JavaScript

Animation.pause() — colocar uma animação em pausa

Animation.pause() suspende a reprodução de uma animação sem a cancelar. A operação pode ficar pendente; animation.ready permite esperar que seja concluída.

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

Sintaxe

animation.pause();

animation.pause() não aceita argumentos e devolve undefined, não uma promessa. Suspende o avanço do tempo da animação; play() retoma a reprodução, enquanto cancel() a cancela.

Colocar em pausa pode exigir sincronização. Use await animation.ready em vez de await animation.pause(). Observar apenas playState === 'paused' não prova que a operação terminou: pending ainda pode ser true.

Esta é uma API de navegador Web Animations, não uma funcionalidade ECMAScript. Não deduza o suporte a partir da versão do Node.js; verifique os navegadores de destino.

Exemplos

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

Resultado

paused
500
false

O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.

Fontes