HTMLMediaElement: currentTime-Eigenschaft

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.

Die currentTime-Eigenschaft des HTMLMediaElement-Interfaces gibt die aktuelle Wiedergabezeit in Sekunden an.

Das Ändern des Wertes von currentTime 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 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 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 der duration-Eigenschaft bestimmt werden.

Beispiele

js
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 Präferenz privacy.reduceTimerPrecision standardmäßig aktiviert und beträgt standardmäßig 2ms. Sie können auch privacy.resistFingerprinting aktivieren, in welchem Fall die Präzision 100ms oder der Wert von privacy.resistFingerprinting.reduceTimerPrecision.microseconds beträgt, je nachdem, welcher größer 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.

js
// 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

Specification
HTML Standard
# dom-media-currenttime-dev

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch