Animation: finished プロパティ

Baseline 広く利用可能

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

Animation.finished はウェブアニメーション API の読み取り専用プロパティで、アニメーションの再生が完了すると解決される Promise を返します。

メモ: アニメーションが finished の再生状態から離れる時点（つまり、再び再生を始める時点）ごとに、このプロパティに対して新しい Promise が作成されます。新しい Promise は新しいアニメーションシーケンスが完了すると解決されます。

値

アニメーションの実行が完了すると解決される Promise オブジェクト。

以下のコードは、要素 elem で実行するアニメーションがすべて完了するまで待ち、その要素を DOM ツリーから削除します。

Promise.all(elem.getAnimations().map((animation) => animation.finished)).then(
  () => elem.remove(),
);

仕様書
Web Animations # dom-animation-finished

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