TimeRanges

Baseline 已廣泛支援

此特性已相當成熟,可在許多裝置和瀏覽器版本上使用。自 ⁨2015 年 7 月⁩以來,各瀏覽器均已提供此特性。

在載入供 <audio><video> 元素使用的媒體資源時,TimeRanges 介面用於表示已緩衝的媒體資源時間範圍、已播放的時間範圍以及可搜尋的時間範圍。

TimeRanges 物件包含一個或多個時間範圍,每個範圍由一個起始時間和結束時間偏移量指定。您可以透過使用 start()end() 方法來引用每個時間範圍,傳入您想要檢索的時間範圍的索引號。

規範化的 TimeRanges 物件

HTMLMediaElement 物件的一些成員會返回一個規範化的 TimeRanges 物件——規範將其描述為具有以下特徵:

此類物件中的範圍是有序的、不重疊且不相鄰的(相鄰範圍會被合併成一個更大的範圍)。一個範圍可以是空的(僅引用一個單一的時間點)。

例項屬性

TimeRanges.length 只讀

返回一個 unsigned long,表示時間範圍物件所表示的時間範圍的數量。

例項方法

TimeRanges.start()

返回具有指定索引的範圍開始時間。

TimeRanges.end()

返回指定範圍的結束時間。

規範

規範
HTML
# time-ranges

瀏覽器相容性