TimeRanges

Beim Laden einer Medienressource zur Verwendung durch ein <audio>- oder <video>-Element wird die TimeRanges-Schnittstelle zur Darstellung der Zeitbereiche der Medienressource verwendet, die gepuffert wurden, die abgespielt wurden und die verfügbar sind zum Suchen.

Ein TimeRanges-Objekt umfasst einen oder mehrere Zeitbereiche, die jeweils durch einen Startzeitoffset und einen Endzeitoffset spezifiziert sind. Sie beziehen sich auf jeden Zeitbereich, indem Sie die Methoden start() und end() verwenden und die Indexnummer des Zeitbereichs übergeben, den Sie abrufen möchten.

Normalisierte TimeRanges-Objekte

Mehrere Mitglieder von HTMLMediaElement-Objekten geben ein normalisiertes TimeRanges-Objekt zurück — das die Spezifikation beschreibt als mit den folgenden Eigenschaften:

Die Bereiche in einem solchen Objekt sind geordnet, überlappen sich nicht und berühren sich nicht (angrenzende Bereiche werden zu einem größeren Bereich zusammengefasst). Ein Bereich kann leer sein (bezieht sich nur auf einen einzelnen Zeitpunkt).

Instanz-Eigenschaften

TimeRanges.length Schreibgeschützt

Gibt ein unsigned long zurück, das die Anzahl der Zeitbereiche repräsentiert, die durch das Zeitbereichsobjekt dargestellt werden.

Instanz-Methoden

TimeRanges.start()

Gibt die Zeit für den Beginn des Bereichs mit dem angegebenen Index zurück.

TimeRanges.end()

Gibt die Zeit für das Ende des angegebenen Bereichs zurück.

Spezifikationen

Specification
HTML
# time-ranges

Browser-Kompatibilität

Report problems with this compatibility data on GitHub
desktopmobile
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
TimeRanges
end
length
start

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support