动画：cancel() 方法

基线 广泛可用

此功能已经成熟，可在许多设备和浏览器版本上运行。它自以下时间起在所有浏览器中可用： 2020 年 3 月.

Web 动画 API 的 Animation 接口的 cancel() 方法清除由此动画引起的全部 KeyframeEffect，并中止其播放。

注意：取消动画时，其 startTime 和 currentTime 将设置为 null。

语法

js
cancel()

参数

无。

返回值

无 (undefined)。

异常

此方法不会直接抛出异常；但是，如果动画的 playState 在取消时不是 "idle"，则 当前已完成的 Promise 将被拒绝，并显示一个名为 AbortError 的 DOMException。

规范

规范
Web 动画
# dom-animation-cancel

浏览器兼容性

BCD 表格仅在启用 JavaScript 的浏览器中加载。

另请参阅