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.