Animation.cancel()
ウェブアニメーション API の cancel() は Animation インターフェイスのメソッドで、このアニメーションによって引き起こされたすべての KeyframeEffect (en-US)を初期化し、再生を中止します。
メモ: アニメ―ションをキャンセルした時、startTime (en-US) と currentTime (en-US) は、 null に設定されます。
構文
js
Animation.cancel();
引数
なし
返値
なし
例外
このメソッドは、直接は例外を発生しません。しかし、キャンセル時にアニメーションの playState (en-US) が "idle" 以外の場合、 current finished promise (en-US) は DOMException の AbortError で拒否されます。
仕様書
| Specification |
|---|
| Web Animations # dom-animation-cancel |
ブラウザーの互換性
BCD tables only load in the browser
関連情報
- ウェブアニメーション API
KeyframeEffect(en-US)AnimationAnimation.playState(en-US)Animation.finished(en-US) はこのアニメーションのplayStateが"idle"でなくなると拒否されるこの操作のプロミスを返します。