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

View in English Always switch to English

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 动画 APIAnimation 接口的 cancel() 方法会清除由该动画产生的所有 KeyframeEffect,并中止其播放。

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

语法

js
cancel()

参数

无。

返回值

无(undefined)。

异常

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

规范

Specification
Web Animations
# dom-animation-cancel

浏览器兼容性

参见