Animation: cancel() メソッド

Baseline 広く利用可能

この機能は広く実装されており、多くのバージョンの端末やブラウザーで動作します。2020年3月以降、すべてのブラウザーで利用可能です。

ウェブアニメーション API の cancel() は Animation インターフェイスのメソッドで、このアニメーションによって引き起こされたすべての KeyframeEffectを初期化し、再生を中止します。

メモ: アニメ―ションをキャンセルした時、startTime と currentTime は、 null に設定されます。

構文

cancel()

なし。

なし。

このメソッドは、直接は例外を発生しません。しかし、キャンセル時にアニメーションの playState が "idle" 以外の場合、 current finished promise は DOMException の AbortError で拒否されます。

仕様書
Web Animations # dom-animation-cancel

このページは MDN の貢献者によって 2024年7月28日に最終更新されました。