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
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.
// 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
HTMLMediaElement
: Interface zur Definition derHTMLMediaElement.currentTime
-EigenschaftHTMLMediaElement.fastSeek()
: Eine andere Möglichkeit, die Zeit einzustellenHTMLMediaElement.duration
: Die Dauer des Mediums in Sekunden