CKTIS / JavaScript
HTMLMediaElement: `paused` ter dogodki `play`, `pause`, `ended` in `error`
Loči trenutno stanje predvajanja od dogodkov in izida klica `play()`. Prepoznaj začasno ustavitev, naravni konec predvajanja in napako pri predstavnostnem viru.
Različica: ECMAScript 2024 and the current web platform; runtime support varies
Sintaksa
media.paused
media.ended
media.error
media.play() // Promise<void>
media.pause() // undefined
media.addEventListener("play", listener)
media.addEventListener("pause", listener)
media.addEventListener("ended", listener)
media.addEventListener("error", listener)HTMLMediaElement je vmesnik spletne platforme za zvočne in videoelemente in ni del ECMAScripta. Logična lastnost media.paused je samo za branje in ima sprva vrednost true. Vrednost false pomeni, da element ni v stanju začasne ustavitve, ne zagotavlja pa, da predvajanje napreduje: element morda čaka na podatke.
play() poskusi začeti ali nadaljevati predvajanje. Vrne obljubo, ki se ob uspešnem začetku predvajanja izpolni, ob neuspehu pa zavrne, na primer z napako NotAllowedError, če pravila samodejnega predvajanja blokirajo zahtevo. Dogodek play se uvrsti v čakalno vrsto, ko se paused spremeni iz true v false. To ni dogodek playing, ki naznani začetek ali nadaljevanje po čakanju na podatke. pause() vrne undefined in ne povzroči novega prehoda, če je predvajanje že začasno ustavljeno. Dogodek pause nastopi po prehodu v stanje začasne ustavitve.
ended označuje konec predvajanja, ne navadne začasne ustavitve. Ob naravnem koncu predvajanja naprej se lahko pause zgodi pred ended brez klica pause(). Če velja loop === true in je playbackRate nenegativen, se ended ne sproži. Logična lastnost media.ended opisuje stanje, ne dogodka.
Te štiri dogodke poslušaj neposredno na elementu: ne širijo se navzgor po drevesu DOM in jih ni mogoče preklicati. Dogodek error naznani napako vira, na primer pri nalaganju ali dekodiranju. Preveri media.error: to je MediaError z lastnostjo code ali null, če ni zabeležene napake. Zavrnitev obljube iz play() obravnavaj posebej; blokirano samodejno predvajanje samo po sebi ni napaka vira.
Primeri
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<title>Media playback events</title>
</head>
<body>
<audio id="media"></audio>
<button id="start" type="button">Run media demo</button>
<script>
(() => {
// Build one second of silent, unsigned 8-bit mono PCM WAV.
const rate = 8000;
const wav = new Uint8Array(44 + rate);
const view = new DataView(wav.buffer);
const text = (offset, value) => {
for (let i = 0; i < value.length; i++) wav[offset + i] = value.charCodeAt(i);
};
text(0, "RIFF");
view.setUint32(4, wav.length - 8, true);
text(8, "WAVEfmt ");
view.setUint32(16, 16, true);
view.setUint16(20, 1, true);
view.setUint16(22, 1, true);
view.setUint32(24, rate, true);
view.setUint32(28, rate, true);
view.setUint16(32, 1, true);
view.setUint16(34, 8, true);
text(36, "data");
view.setUint32(40, rate, true);
wav.fill(128, 44);
const media = document.getElementById("media");
const start = document.getElementById("start");
media.addEventListener("play", () => console.log(`play: paused=${media.paused}`));
media.addEventListener("pause", () => console.log(`pause: paused=${media.paused}`));
media.addEventListener("ended", () => {
console.log(`ended: ended=${media.ended}`);
media.src = "data:text/plain,not-a-media-file";
}, { once: true });
media.addEventListener("error", () => console.log(`error: code=${media.error?.code}`));
start.addEventListener("click", async () => {
start.remove();
console.log(`paused=${media.paused}`);
media.src = `data:audio/wav;base64,${btoa(String.fromCharCode(...wav))}`;
try {
await media.play();
} catch (error) {
console.log(`play() rejected: ${error.name}`);
}
}, { once: true });
})();
</script>
</body>
</html>Rezultat
paused=true play: paused=false pause: paused=true ended: ended=true error: code=4
Shrani primer kot `media-demo.html` in ga odpri v brskalniku. Odpri konzolo brskalnika in klikni `Run media demo`. Predvideno zaporedje zahteva podporo za PCM WAV, dovoljenje za uporabo naslovov `data:` za predstavnost in neprekinjeno predvajanje. Po eni sekundi tišine naravni konec sproži `pause` pred `ended`; šele nato koda nastavi namenoma neveljaven vir. Če je obljuba iz `play()` zavrnjena, preveri ime napake, namesto da pričakuješ celotno zaporedje.
Povezane lekcije
- JavaScript · Lekcija 34 · Napredna · Različica: 4