TimeRanges

Baseline 已广泛支持

此特性已相当成熟,可在许多设备和浏览器版本上使用。自 ⁨2015 年 7 月⁩以来,各浏览器均已提供此特性。

在加载供 <audio><video> 元素使用的媒体资源时,TimeRanges 接口用于表示已缓冲的媒体资源时间范围、已播放的时间范围以及可搜寻的时间范围。

TimeRanges 对象包含一个或多个时间范围,每个范围由一个起始时间和结束时间偏移量指定。您可以通过使用 start()end() 方法来引用每个时间范围,传入您想要检索的时间范围的索引号。

规范化的 TimeRanges 对象

HTMLMediaElement 对象的一些成员会返回一个规范化的 TimeRanges 对象——规范将其描述为具有以下特征:

此类对象中的范围是有序的、不重叠且不相邻的(相邻范围会被合并成一个更大的范围)。一个范围可以是空的(仅引用一个单一的时间点)。

实例属性

TimeRanges.length 只读

返回一个 unsigned long,表示时间范围对象所表示的时间范围的数量。

实例方法

TimeRanges.start()

返回具有指定索引的范围开始时间。

TimeRanges.end()

返回指定范围的结束时间。

规范

规范
HTML
# time-ranges

浏览器兼容性