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

<p><strong><code>HTMLMediaElement.buffered</code></strong> 返回一个只读 {{domxref("TimeRanges")}} 对象 返回媒体已缓冲的区域</p>

<div class="note"><strong>Note:</strong> This feature is not available in <a href="/en-US/docs/Web/API/Web_Workers_API">Web Workers</a>.</div>

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

<pre class="syntaxbox">var <em>timeRange</em> = <em>audioObject</em>.buffered</pre>

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

<p>对象{{domxref("TimeRanges")}}</p>

<p>length - 获得音频/视频中已缓冲范围的数量</p>

<p>buffered.start 开始的区域 </p>

<p>buffered.end 结束的区域</p>

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

<pre>var obj = document.createElement('video');
console.log(obj.buffered); // TimeRanges { length: 0 }
console.log(obj.buffered.start(0));//第一个缓存开始的区域
console.log(obj.buffered.end(0));//第一个缓存结束的区域</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('HTML WHATWG', "embedded-content.html#media-elements", "HTMLMediaElement.buffered")}}</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.buffered")}}</td>
   <td>{{Spec2('HTML5 W3C')}}</td>
   <td>Initial definition.</td>
  </tr>
 </tbody>
</table>

<h2 id="浏览器兼容性">浏览器兼容性</h2>

{{Compat("api.HTMLMediaElement.buffered")}}

<h2 id="See_Also" name="See_Also"><font><font>也可以看看</font></font></h2>

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