HTMLMediaElement: currentTime-Eigenschaft

Wert

Ein Gleitkommawert mit doppelter Genauigkeit, der die aktuelle Wiedergabezeit in Sekunden angibt.

Wenn das Medium noch nicht abgespielt wird, gibt der Wert von currentTime die Zeitposition innerhalb des Mediums an, bei der die Wiedergabe beginnt, sobald die play()-Methode aufgerufen wird.

Das Setzen von currentTime auf einen neuen Wert springt den Medieninhalt zur angegebenen Zeit, sofern das Medium verfgbar ist.

Bei Medien ohne bekannte Dauerwie beispielsweise live gestreamte Medienkann es sein, dass der Browser Teile des Mediums, die aus dem Medienpuffer abgelaufen sind, nicht abrufen kann. Auerdem kann bei Medien, deren Zeitachse nicht bei 0 Sekunden beginnt, nicht zu einer Zeit vor der frhesten Zeit ihrer Zeitachse gesprungen werden.

Die Lnge des Mediums in Sekunden kann mit der duration-Eigenschaft bestimmt werden.

Beispiele

const video = document.createElement("video");
console.log(video.currentTime);

Nutzungshinweise

Reduzierte Zeitgenauigkeit

Um Schutz vor Timing-Angriffen und Fingerprinting zu bieten, kann die Genauigkeit von video.currentTime je nach Browsereinstellung gerundet werden. In Firefox ist die Prferenz privacy.reduceTimerPrecision standardmig aktiviert und betrgt standardmig 2ms. Sie knnen auch privacy.resistFingerprinting aktivieren, in welchem Fall die Przision 100ms oder der Wert von privacy.resistFingerprinting.reduceTimerPrecision.microseconds betrgt, je nachdem, welcher grer ist.

Zum Beispiel wird mit reduzierter Zeitgenauigkeit das Ergebnis von video.currentTime immer ein Vielfaches von 0,002 sein, oder ein Vielfaches von 0,1 (oder privacy.resistFingerprinting.reduceTimerPrecision.microseconds), wenn privacy.resistFingerprinting aktiviert ist.

// reduced time precision (2ms) in Firefox 60
video.currentTime;
// Might be:
// 23.404
// 24.192
// 25.514
// 

// reduced time precision with `privacy.resistFingerprinting` enabled
video.currentTime;
// Might be:
// 49.8
// 50.6
// 51.7
// 

Spezifikationen

Browser-Kompatibilitt

Siehe auch

• HTMLMediaElement: Interface zur Definition der HTMLMediaElement.currentTime-Eigenschaft
• HTMLMediaElement.fastSeek(): Eine andere Mglichkeit, die Zeit einzustellen
• HTMLMediaElement.duration: Die Dauer des Mediums in Sekunden