---
title: Animation.finished
slug: Web/API/Animation/finished
translation_of: Web/API/Animation/finished
---
<p>{{ SeeCompatTable() }}{{ APIRef("Web Animations API") }}</p>

<p>Animation.finished只读属性允许您返回动画的完成状态。</p>

<div class="note">
<p><strong>Note</strong>: The Promise is replaced with a new (pending) Promise object every time the animation leaves the <code>finished</code> play state.</p>
</div>

<h2 id="语法">语法</h2>

<div class="syntaxbox">
<pre class="brush: js">var animationsPromise = animation<em>.finished</em>;
</pre>
</div>

<h3 id="值">值</h3>

<p>一个Promise对象。</p>

<h2 id="例子">例子</h2>

<p>以下代码会等到所有动画都完成，然后再移除它们处于活动状态的元素：</p>

<pre class="brush: js">Promise.all(
  elem.getAnimations().map(
    function(animation) {
      return animation.finished
    }
  )
).then(
  function() {
    return elem.remove();
  }
);</pre>

<h2 id="规范">规范</h2>

<table class="standard-table">
 <tbody>
  <tr>
   <th scope="col">Specification</th>
   <th scope="col">Status</th>
   <th scope="col">Comment</th>
  </tr>
  <tr>
   <td>{{SpecName('Web Animations', '#dom-animation-finished', 'Animation.finished' )}}</td>
   <td>{{Spec2('Web Animations')}}</td>
   <td>Editor's draft.</td>
  </tr>
 </tbody>
</table>

<h2 id="浏览器支持">浏览器支持</h2>

<div>{{CompatibilityTable}}</div>

<div id="compat-desktop">
<table class="compat-table">
 <tbody>
  <tr>
   <th>Feature</th>
   <th>Chrome</th>
   <th>Firefox (Gecko)</th>
   <th>Internet Explorer</th>
   <th>Opera</th>
   <th>Safari (WebKit)</th>
  </tr>
  <tr>
   <td>Basic support</td>
   <td>{{CompatNo}}</td>
   <td>{{CompatNo}}</td>
   <td>{{CompatNo}}</td>
   <td>{{CompatNo}}</td>
   <td>{{CompatNo}}</td>
  </tr>
 </tbody>
</table>
</div>

<div id="compat-mobile">
<table class="compat-table">
 <tbody>
  <tr>
   <th>Feature</th>
   <th>Android</th>
   <th>Firefox Mobile (Gecko)</th>
   <th>IE Phone</th>
   <th>Opera Mobile</th>
   <th>Safari Mobile</th>
  </tr>
  <tr>
   <td>Basic support</td>
   <td>{{CompatNo}}</td>
   <td>{{CompatNo}}</td>
   <td>{{CompatNo}}</td>
   <td>{{CompatNo}}</td>
   <td>{{CompatNo}}</td>
  </tr>
 </tbody>
</table>
</div>

<p> </p>

<h2 id="相关内容" style="line-height: 30px; font-size: 2.14285714285714rem;">相关内容</h2>

<ul>
 <li><a href="/en-US/docs/Web/API/KeyframeEffect">KeyframeEffect Interface</a></li>
 <li><a href="/en-US/docs/Web/API/Web_Animations_API">Web Animations API</a></li>
 <li>{{domxref("Animation")}}</li>
</ul>