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 Nur lesbar

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 Standard
# time-ranges

Browser-Kompatibilität

BCD tables only load in the browser