Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

Animation.pause() — wstrzymanie animacji

Animation.pause() wstrzymuje odtwarzanie animacji bez jej anulowania. Operacja może być oczekująca; animation.ready pozwala poczekać na jej zakończenie.

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

Składnia

animation.pause();

animation.pause() nie przyjmuje argumentów i zwraca undefined, nie obietnicę. Wstrzymuje upływ czasu animacji; play() wznawia odtwarzanie, a cancel() je anuluje.

Wstrzymanie może wymagać synchronizacji. Użyj await animation.ready, zamiast await animation.pause(). Samo playState === 'paused' nie dowodzi zakończenia operacji: pending może nadal wynosić true.

To API przeglądarkowe Web Animations, nie funkcja ECMAScript. Nie zakładaj obsługi na podstawie wersji Node.js; sprawdź docelowe przeglądarki.

Przykłady

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

Wynik

paused
500
false

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła