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
KeyframeEffect
Animation
Animation.playState
Animation.finished
返回的 promise,如果动画的playState
不是"idle"
,将会拒绝。