DiecurrentTime-Eigenschaft desHTMLMediaElement-Interfaces gibt die aktuelle Wiedergabezeit in Sekunden an.

Das Ändern des Wertes voncurrentTime springt den Medieninhalt zur neuen Zeit.

Wert

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

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

Das Setzen voncurrentTime auf einen neuen Wert springt den Medieninhalt zur angegebenen Zeit, sofern das Medium verfügbar ist.

Bei Medien ohne bekannte Dauer—wie beispielsweise live gestreamte Medien—kann es sein, dass der Browser Teile des Mediums, die aus dem Medienpuffer abgelaufen sind, nicht abrufen kann. Außerdem kann bei Medien, deren Zeitachse nicht bei 0 Sekunden beginnt, nicht zu einer Zeit vor der frühesten Zeit ihrer Zeitachse gesprungen werden.

Die Länge des Mediums in Sekunden kann mit derduration-Eigenschaft bestimmt werden.

Beispiele

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

Nutzungshinweise

Reduzierte Zeitgenauigkeit

Um Schutz vor Timing-Angriffen undFingerprinting zu bieten, kann die Genauigkeit vonvideo.currentTime je nach Browsereinstellung gerundet werden. In Firefox ist die Präferenzprivacy.reduceTimerPrecision standardmäßig aktiviert und beträgt standardmäßig 2ms. Sie können auchprivacy.resistFingerprinting aktivieren, in welchem Fall die Präzision 100ms oder der Wert vonprivacy.resistFingerprinting.reduceTimerPrecision.microseconds beträgt, je nachdem, welcher größer ist.

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

// reduced time precision (2ms) in Firefox 60video.currentTime;// Might be:// 23.404// 24.192// 25.514// …// reduced time precision with `privacy.resistFingerprinting` enabledvideo.currentTime;// Might be:// 49.8// 50.6// 51.7// …

Spezifikationen

Browser-Kompatibilität

Siehe auch

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