Animation: ready-Eigenschaft

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since March 2020.

Die schreibgeschützte Animation.ready-Eigenschaft der Web Animations API gibt ein Promise zurück, das aufgelöst wird, wenn die Animation bereit ist, abgespielt zu werden. Ein neues Promise wird jedes Mal erstellt, wenn die Animation in den "pending" play state eintritt, sowie wenn die Animation abgebrochen wird, da in beiden Szenarien die Animation erneut gestartet werden kann.

Hinweis: Da dasselbe Promise sowohl für ausstehende play- als auch pause-Anfragen verwendet wird, wird den Autoren empfohlen, den Status der Animation zu überprüfen, wenn das Promise aufgelöst wird.

Wert

Ein Promise, das aufgelöst wird, wenn die Animation bereit ist, abgespielt zu werden. Sie werden typischerweise eine Konstruktion wie diese verwenden, wenn Sie das ready-Promise verwenden:

js
animation.ready.then(() => {
  // Do whatever needs to be done when
  // the animation is ready to run
});

Beispiele

Im folgenden Beispiel wird der Zustand der Animation running sein, wenn das aktuelle ready Promise aufgelöst wird, da die Animation den pending play state nicht zwischen den Aufrufen von pause und play verlässt und daher das aktuelle ready Promise nicht geändert wird.

js
animation.pause();
animation.ready.then(() => {
  // Displays 'running'
  alert(animation.playState);
});
animation.play();

Spezifikationen

Specification
Web Animations
# dom-animation-ready

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch