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
# dom-media-currenttime-dev

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
currentTime

Legend

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

Full support
Full support

Siehe auch