此页面由社区从英文翻译而来。了解更多并加入 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

浏览器兼容性

参见