Animation:cancel() 方法
Baseline
Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since 2020年3月.
Web 动画 API 中 Animation 接口的 cancel() 方法会清除由该动画产生的所有 KeyframeEffect,并中止其播放。
备注:
当动画被取消时,startTime 和 currentTime 会被设为 null。
语法
js
cancel()
参数
无。
返回值
无(undefined)。
异常
该方法本身不会直接抛出异常;但是,如果在动画被取消时,playState 不设为 "idle",则当前的 finished promise 会以名为 AbortError 的 DOMException 被拒绝。
规范
| Specification |
|---|
| Web Animations> # dom-animation-cancel> |
浏览器兼容性
Loading…
参见
- Web 动画 API
KeyframeEffectAnimationAnimation.playStateAnimation.finished返回的 promise,如果动画的playState不是"idle",将会拒绝。