此页面由社区从英文翻译而来。了解更多并加入 MDN Web Docs 社区。

View in English Always switch to English

Animation:cancel() 方法

基线 广泛可用

自 2020年3月 起,此特性已在主流浏览器中得到支持,可在大多数设备和浏览器版本中正常使用。

Web 动画 APIAnimation 接口的 cancel() 方法会清除由该动画产生的所有 KeyframeEffect,并中止其播放。

备注:当动画被取消时,startTimecurrentTime 会被设为 null

语法

js
cancel()

参数

无。

返回值

无(undefined)。

异常

该方法本身不会直接抛出异常;但是,如果在动画被取消时,playState 不设为 "idle",则当前的 finished promise 会以名为 AbortErrorDOMException 被拒绝。

规范

规范
Web Animations
# dom-animation-cancel

浏览器兼容性

参见