CKTIS / JavaScript
Estado e tempo de reprodução: paused, muted, currentTime e duration
Consulta separadamente a pausa e o estado do som, define a posição de reprodução em segundos e distingue uma duração conhecida de `NaN` e `Infinity`.
Versão: ECMAScript 2024 and the current web platform; runtime support varies
Sintaxe
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 são propriedades de instância de HTMLMediaElement, disponíveis nos elementos audio e video. Pertencem à plataforma web, não ao próprio ECMAScript, pelo que não deves presumir que existem num ambiente sem DOM.
paused é um booleano só de leitura. Um elemento novo começa com paused === true. Chama pause() e play() em vez de atribuíres um valor a paused. A promessa devolvida por play() pode ser rejeitada, por exemplo se o navegador bloquear a reprodução automática. paused === false não garante que a posição avance: o elemento pode estar à espera de dados.
muted é um booleano de leitura e escrita que indica se o som está silenciado. media.muted = true silencia a saída de áudio; false desativa o silenciamento. Silenciar não equivale a pôr em pausa nem a definir volume como zero. defaultMuted reflete o atributo HTML muted, que indica o estado de silenciamento predefinido, não o estado atual.
currentTime devolve a posição de reprodução na linha temporal do conteúdo, em segundos, incluindo frações. Antes de os metadados estarem disponíveis, uma atribuição guarda a posição inicial pedida; depois, inicia um salto para outra posição. NaN e os valores infinitos causam um TypeError. A posição efetiva pode diferir da pedida: consulta os intervalos de seekable, sobretudo nas transmissões em direto, e usa seeked para detetar o fim do salto.
duration é só de leitura. Um valor finito indica o ponto final em segundos na linha temporal do conteúdo, ou seja, a duração se a linha começar no zero. NaN significa que a duração ainda não está disponível; Infinity indica que não há um fim conhecido. Lê o valor em loadedmetadata e atualiza-o em durationchange. Se a linha temporal começar no zero, calcula currentTime / duration apenas quando Number.isFinite(duration) && duration > 0.
Exemplos
<!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>Resultado
currentTime=0 paused=true, muted=true, currentTime=2.5, duration=NaN
Guarda o exemplo como ficheiro HTML, abre-o num navegador e consulta a consola. O elemento não tem uma fonte: `2.5` é a posição inicial guardada, não o resultado de um salto nem da reprodução. O elemento continua em pausa e `duration` permanece `NaN`.
Lições relacionadas
- JavaScript · Lição 28 · Intermédio · Versão: 3