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 Animation Schnittstelle entfernt alle durch diese Animation verursachten KeyframeEffects und bricht deren Wiedergabe ab.
Hinweis:
Wenn eine Animation abgebrochen wird, werden ihr startTime und currentTime auf null gesetzt.
Syntax
js
cancel()
Parameter
Keine.
Rückgabewert
Keiner (undefined).
Ausnahmen
Diese Methode wirft keine Ausnahmen direkt; jedoch, wenn der playState der Animation beim Abbruch anders als "idle" ist, wird das aktuelle abgeschlossene 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.