WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / JavaScript

Animation.pause() — eine Animation pausieren

Animation.pause() hält die Wiedergabe einer Animation an, ohne sie abzubrechen. Der Vorgang kann noch ausstehen; mit animation.ready kannst du auf seinen Abschluss warten.

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

Syntax

animation.pause();

animation.pause() nimmt keine Argumente entgegen und gibt undefined zurück, kein Promise. Die Methode hält den Zeitfortschritt der Animation an; play() setzt die Wiedergabe fort, während cancel() sie abbricht.

Das Pausieren kann eine Synchronisierung erfordern. Verwende await animation.ready statt await animation.pause(). Allein die Beobachtung von playState === 'paused' beweist nicht, dass der Vorgang abgeschlossen ist: pending kann weiterhin true sein.

Dies ist eine Web-Animations-Browser-API und keine ECMAScript-Funktion. Leite die Unterstützung nicht aus einer Node.js-Version ab, sondern prüfe die Zielbrowser.

Beispiele

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

Ergebnis

paused
500
false

Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.

Quellen