HTMLTimeRanges object

Stores a collection of ranges (periods) of time.

HTML5 A vocabulary and associated APIs for HTML and XHTML, Section 4

Members

The HTMLTimeRanges object has these types of members:

Methods
Properties

Methods

The HTMLTimeRanges object has these methods.

Method	Description
end	Returns the end of the time range by using the specified index.
start	Gets the start of the time range by using the specified index.

Properties

The HTMLTimeRanges object has these properties.

Property	Description
length	The number of time ranges in the collection.

Standards information

HTML5 A vocabulary and associated APIs for HTML and XHTML, Section 4

Remarks

A HTMLTimeRanges object represents the collection of ranges from the media resource that have been buffered or played. Ranges in a HTMLTimeRanges collection are sequential and not empty. Adjacent ranges are combined together to create longer ones.

Examples

The following script shows how to access the list of ranges that have been played.

JavaScript


var ranges = document.getElementById('myVideo').played;
for (var i=0; i<ranges.length; i++){
    var start = ranges.start(i);
    var end = ranges.end(i);
    // display results to developer tools console window
    if (window.console.log){ 
      window.console.log("Played from " + start + " to " + end); 
    }
}