CKTIS / JavaScript
Stato e tempo di riproduzione: paused, muted, currentTime e duration
Controlla separatamente pausa e silenziamento, imposta la posizione di riproduzione in secondi e distingui una durata nota da `NaN` e `Infinity`.
Versione: ECMAScript 2024 and the current web platform; runtime support varies
Sintassi
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 e duration sono proprietà di istanza di HTMLMediaElement disponibili sugli elementi audio e video. Appartengono alla piattaforma web, non a ECMAScript stesso, quindi non dare per scontato che esistano in un ambiente senza DOM.
paused è un booleano di sola lettura. Un nuovo elemento parte con paused === true. Chiama pause() e play() invece di assegnare un valore a paused. La promessa restituita da play() può essere rifiutata, per esempio se il browser blocca la riproduzione automatica. paused === false non garantisce che la posizione avanzi: l’elemento potrebbe essere in attesa di dati.
muted è un booleano leggibile e modificabile che indica se l’audio è silenziato. media.muted = true silenzia l’uscita audio; false disattiva il silenziamento. Silenziare non equivale a mettere in pausa né a impostare volume a zero. defaultMuted riflette l’attributo HTML muted, che specifica lo stato di silenziamento predefinito, non quello corrente.
currentTime restituisce la posizione di riproduzione sulla linea temporale del contenuto, in secondi, anche frazionari. Prima che i metadati siano disponibili, un’assegnazione memorizza la posizione iniziale richiesta; dopo, avvia uno spostamento. NaN e i valori infiniti causano un TypeError. La posizione effettiva può differire da quella richiesta: controlla gli intervalli di seekable, soprattutto nei flussi in diretta, e usa seeked per sapere quando termina lo spostamento.
duration è di sola lettura. Un valore finito è il punto finale in secondi sulla linea temporale del contenuto, cioè la sua durata se la linea parte da zero. NaN significa che la durata non è ancora disponibile; Infinity indica che non si conosce il punto finale. Leggi il valore all’evento loadedmetadata e aggiornalo a durationchange. Se la linea temporale parte da zero, calcola currentTime / duration solo quando Number.isFinite(duration) && duration > 0.
Esempi
<!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>Risultato
currentTime=0 paused=true, muted=true, currentTime=2.5, duration=NaN
Salva l’esempio come file HTML, aprilo in un browser e controlla la console. L’elemento non ha una sorgente: `2.5` è la posizione iniziale memorizzata, non il risultato di uno spostamento o della riproduzione. L’elemento resta in pausa e `duration` rimane `NaN`.
Lezioni correlate
- JavaScript · Lezione 28 · Intermedio · Versione: 3