---
title: HTMLMediaElement.readyState
slug: Web/API/HTMLMediaElement/readyState
translation_of: Web/API/HTMLMediaElement/readyState
---
<div>{{APIRef("HTML DOM")}}</div>

<div><strong><code>HTMLMediaElement.readyState</code> </strong>屬性回傳目前媒體的就緒狀態。</div>

<h2 id="Syntax" name="Syntax">語法</h2>

<pre class="syntaxbox">var readyState = audioOrVideo.readyState;</pre>

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

<p>一個 <code>unsigned short</code>，可能的值有：</p>

<table class="standard-table">
 <thead>
  <tr>
   <th scope="col">常數</th>
   <th scope="col">值</th>
   <th scope="col">描述</th>
  </tr>
 </thead>
 <tbody>
  <tr>
   <td>HAVE_NOTHING</td>
   <td>0</td>
   <td>沒有可用的媒體資源。</td>
  </tr>
  <tr>
   <td>HAVE_METADATA</td>
   <td>1</td>
   <td>已經取得足夠的媒體資源並已初始化元資料。繼續取得媒體資源不會導致例外。</td>
  </tr>
  <tr>
   <td>HAVE_CURRENT_DATA</td>
   <td>2</td>
   <td>媒體資料已經足夠播放目前的時間，但沒有足夠的資料再播放一幀。</td>
  </tr>
  <tr>
   <td>HAVE_FUTURE_DATA</td>
   <td>3</td>
   <td>資料已經足夠播放目前的時間，而且有至少一點點資料可以播放未來的時間（換句話說，可能只多了一到兩幀）。</td>
  </tr>
  <tr>
   <td>HAVE_ENOUGH_DATA</td>
   <td>4</td>
   <td>資料足夠，且下載率夠高。媒體可以播放到結束而不被中斷。</td>
  </tr>
 </tbody>
</table>

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

<p>下面這個例子會監聽 `example` 這個元素，並檢查是否已載入足夠的媒體資源。如果是的話，它會繼續播放。</p>

<pre class="brush: html">&lt;audio id="example" preload="auto"&gt;
 &lt;source src="sound.ogg" type="audio/ogg" /&gt;
&lt;/audio&gt;

</pre>

<pre class="brush: js">var obj = document.getElementById('example');

obj.addEventListener('loadeddata', function() {

  if(obj.readyState &gt;= 2) {
    obj.play();
  }

});
</pre>

<p> </p>

<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('HTML WHATWG', "the-video-element.html#htmlmediaelement", "HTMLMediaElement.readyState")}}</td>
   <td>{{Spec2('HTML WHATWG')}}</td>
   <td>No change from {{SpecName('HTML5 W3C')}}</td>
  </tr>
  <tr>
   <td>{{SpecName('HTML5 W3C', "embedded-content-0.html#htmlmediaelement", "HTMLMediaElement.readyState")}}</td>
   <td>{{Spec2('HTML5 W3C')}}</td>
   <td>Initial definition.</td>
  </tr>
 </tbody>
</table>

<h2 id="瀏覽器相容性">瀏覽器相容性</h2>



<p>{{Compat("api.HTMLMediaElement.readyState")}}</p>

<h2 id="See_Also" name="See_Also">也參考看看</h2>

<ul>
 <li>The interface defining it, {{domxref("HTMLMediaElement")}}.</li>
</ul>