TimeRanges

The TimeRanges interface is used to represent a set of time ranges, primarily for the purpose of tracking which portions of media have been buffered when loading it for use by the <audio> and <video> elements.

A TimeRanges object includes one or more ranges of time, each specified by a starting and ending time offset. You reference each time range by using the start() and end() methods, passing the index number of the time range you want to retrieve.

The term "normalized TimeRanges object" indicates that ranges in such an object are ordered, don't overlap, aren't empty, and don't touch (adjacent ranges are folded into one bigger range).

Properties

TimeRanges.length Read only
Returns an unsigned long representing the number of time ranges represented by the time range object.

Methods

TimeRanges.start()
Returns the time for the start of the range with the specified index.
TimeRanges.end()
Returns the time for the end of the specified range.

Specifications

Specification Status Comment
WHATWG HTML Living Standard
The definition of 'TimeRanges' in that specification.
Living Standard Initial definition

Browser compatibility

Feature Chrome Firefox (Gecko) Internet Explorer Opera Safari (WebKit)
Basic support (Yes) (Yes) (Yes) (Yes) ?
Feature Android Firefox Mobile (Gecko) IE Phone Opera Mobile Safari Mobile
Basic support ? ? ? ? ?

Document Tags and Contributors

Contributors to this page: Sebastianz, teoli, shubham.hatwar, Sheppy, Nickolay
Last updated by: Sebastianz,