HTMLMediaElement.buffered

The buffered read-only property of HTMLMediaElement objects returns a new static normalized TimeRanges object that represents the ranges of the media resource, if any, that the user agent has buffered at the moment the buffered property is accessed.

Note: This feature is not available in Web Workers.

Syntax

var timeRange = audioObject.buffered

Value

A new static normalized TimeRanges object that represents the ranges of the media resource, if any, that the user agent has buffered at the moment the buffered property is accessed.

Example

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

Specifications

Specification Status Comment
HTML Living Standard
The definition of 'buffered' in that specification.
Living Standard
Media Source Extensions Recommendation Specifies a new algorithm for returning the buffered ranges of an element whose source is a MediaSource object.

Browser compatibility

BCD tables only load in the browser

See also