CKTIS / JavaScript
État et temps de lecture : paused, muted, currentTime et duration
Distinguez la mise en pause de la coupure du son, réglez la position de lecture en secondes et différenciez une durée connue de `NaN` et `Infinity`.
Version : ECMAScript 2024 and the current web platform; runtime support varies
Syntaxe
media.paused // boolean, read-only
media.muted // boolean, read/write
media.muted = true // mute the audio output
media.currentTime // number in seconds, read/write
media.currentTime = 12.5 // request a position on the media timeline
media.duration // number in seconds, read-only; may be NaN or Infinitypaused, muted, currentTime et duration sont des propriétés d’instance de HTMLMediaElement, disponibles sur les éléments audio et video. Elles relèvent de la plateforme web, pas d’ECMAScript lui-même : ne supposez pas qu’elles existent dans un environnement sans DOM.
paused est un booléen en lecture seule. Un nouvel élément vérifie paused === true. Appelez pause() et play() au lieu d’affecter une valeur à paused. La promesse renvoyée par play() peut être rejetée, par exemple si le navigateur bloque la lecture automatique. paused === false ne garantit pas que la position avance : l’élément peut attendre des données.
muted est un booléen modifiable qui indique si le son est actuellement coupé. media.muted = true coupe le son ; false le rétablit. Couper le son ne revient ni à mettre en pause ni à régler volume sur zéro. defaultMuted reflète l’attribut HTML muted, qui définit la coupure du son par défaut, pas son état actuel.
currentTime donne la position de lecture sur l’axe temporel du média, en secondes, fractions comprises. Avant que les métadonnées soient disponibles, une affectation mémorise la position de départ demandée ; ensuite, elle lance un déplacement dans le média. NaN et les valeurs infinies provoquent une TypeError. La position effective peut différer de la position demandée : consultez les plages de seekable, surtout pour les flux en direct, et utilisez seeked pour détecter la fin du déplacement.
duration est en lecture seule. Une valeur finie indique la position de fin en secondes sur l’axe temporel du média, soit sa durée si cet axe commence à zéro. NaN signifie que la durée n’est pas encore disponible ; Infinity indique que le média n’a pas de fin connue. Lisez la valeur lors de loadedmetadata et actualisez-la lors de durationchange. Si l’axe commence à zéro, calculez currentTime / duration uniquement si Number.isFinite(duration) && duration > 0.
Exemples
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<title>Media playback state and time</title>
</head>
<body>
<script>
const media = document.createElement("video");
console.log(`currentTime=${media.currentTime}`);
media.muted = true;
media.currentTime = 2.5;
console.log(
`paused=${media.paused}, muted=${media.muted}, ` +
`currentTime=${media.currentTime}, duration=${media.duration}`
);
</script>
</body>
</html>Résultat
currentTime=0 paused=true, muted=true, currentTime=2.5, duration=NaN
Enregistrez l’exemple dans un fichier HTML, ouvrez-le dans un navigateur et consultez la console. L’élément n’a pas de source : `2.5` est la position de départ mémorisée, et non le résultat d’un déplacement ou d’une lecture. L’élément reste en pause et `duration` vaut toujours `NaN`.
Leçons associées
- JavaScript · Leçon 28 · Intermédiaire · Version : 3