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

CKTIS / HTML

elemento HTML: audio

O elemento audio incorpora um recurso sonoro e expõe o modelo do navegador para seleção de fonte, memória intermédia, tempo e reprodução.

Versão: WHATWG HTML Living Standard; index snapshot date recorded separately

Sintaxe

<audio controls preload="metadata" src="sound.wav"></audio>

audio pode usar um src ou conter candidatos source ordenados; o type opcional, quando fornecido, ajuda a ignorar formatos não suportados. O texto filho só é recurso para navegadores sem o elemento, não uma alternativa acessível nem transcrição para os que suportam áudio.

controls apresenta controlos nativos, preload é apenas uma indicação e autoplay pode ser bloqueado; muted e loop alteram silêncio inicial e repetição.

play() devolve uma Promise que a política ou uma falha do recurso pode rejeitar; pause() para e currentTime desloca a posição quando o recurso está pronto.

O exemplo espera por loadedmetadata num WAV incorporado e lê duration, paused e o currentSrc resolvido sem iniciar som.

Exemplos

<!doctype html>
<meta charset="utf-8">
<audio id="clip" controls preload="metadata" src="data:audio/wav;base64,UklGRiwAAABXQVZFZm10IBAAAAABAAEAQB8AAEAfAAABAAgAZGF0YQgAAACAgICAgICAgA=="></audio>
<output id="result"></output>
<script>
const clip = document.querySelector("#clip");
clip.addEventListener("loadedmetadata", () => {
  document.querySelector("#result").textContent = `duration=${clip.duration.toFixed(3)}; paused=${clip.paused}; controls=${clip.controls}; source=${clip.currentSrc.startsWith("data:audio/wav")}`;
}, { once: true });
</script>

Resultado

duration=0.001; paused=true; controls=true; source=true

O resultado confirma metadados carregados, controlos nativos e fonte escolhida; não prova reprodução audível nem permissão de autoplay.

Fontes