Animation:cancel() 方法

Baseline 已广泛支持

此功能已经成熟,并可在许多设备和浏览器版本上使用。自 ⁨2020 年 3 月⁩起,它已在各浏览器中推出。

Web Animations APIcancel() 方法,属于 Animation 接口,用于清除此动画引起的所有 KeyframeEffect,并中止其播放。

注意: 当动画被取消时,其 startTimecurrentTime 会被设置为 null

语法

js
cancel()

参数

无。

返回值

无(undefined)。

异常

此方法不会直接抛出异常;但是,如果在取消时动画的 playState 不是 "idle",则当前的完成 promise 会被一个名为 AbortErrorDOMException 拒绝。

规范

规范
Web 动画
# dom-animation-cancel

浏览器兼容性

另见