Animation: cancel() Methode
Baseline
Weitgehend verfügbar
Diese Funktion ist gut etabliert und funktioniert auf vielen Geräten und in vielen Browserversionen. Sie ist seit März 2020 browserübergreifend verfügbar.
Die cancel() Methode des Web Animations API der Schnittstelle Animation löscht alle durch diese Animation verursachten KeyframeEffects und bricht die Wiedergabe ab.
Hinweis:
Wenn eine Animation abgebrochen wird, werden startTime und currentTime auf null gesetzt.
Syntax
js
cancel()
Parameter
Keine.
Rückgabewert
Keine (undefined).
Ausnahmen
Diese Methode wirft direkt keine Ausnahmen; jedoch, wenn der playState der Animation beim Abbruch nicht "idle" ist, wird das aktuelle fertige Versprechen mit einem DOMException namens AbortError abgelehnt.
Spezifikationen
| Spezifikation |
|---|
| Web Animations # dom-animation-cancel |
Browser-Kompatibilität
Siehe auch
- Web Animations API
KeyframeEffectAnimationAnimation.playStateAnimation.finishedgibt das Versprechen zurück, das abgelehnt wird, wenn derplayStateder Animation nicht"idle"ist.