HTMLMediaElement.buffered

The HTMLMediaElement.buffered read-only property returns a new TimeRanges object that indicates the ranges of the media source that the browser has buffered (if any) at the moment the buffered property is accessed.

Note: This feature is not available in Web Workers.

Syntax

var timeRange = audioObject.buffered

Value

A TimeRanges object. This object is normalized, which means that ranges are ordered, don't overlap, aren't empty, and don't touch (adjacent ranges are folded into one bigger range).

Example

var obj = document.createElement('video');
console.log(obj.buffered); // TimeRanges { length: 0 }

Specifications

Specification Status Comment
WHATWG HTML Living Standard
The definition of 'HTMLMediaElement.buffered' in that specification.
Living Standard No change from HTML5
HTML5
The definition of 'HTMLMediaElement.buffered' in that specification.
Recommendation Initial definition.

Browser compatibility

Feature Chrome Firefox (Gecko) Internet Explorer Opera Safari
buffered property (Yes) 4.0 (2.0) 9 ? ?
Feature Android Firefox Mobile (Gecko) Firefox OS (Gecko) IE Mobile Opera Mobile Safari Mobile
buffered property (Yes) 4.0 (2.0) (Yes) ? ? ?

See also

Document Tags and Contributors

 Contributors to this page: teoli, markg
 Last updated by: teoli,