Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

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 Infinity

paused, 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

Fontes