CKTIS / JavaScript
HTMLMediaElement: `paused` i događaji `play`, `pause`, `ended` i `error`
Razlikuj trenutačno stanje reprodukcije od događaja i rezultata poziva `play()`. Prepoznaj pauzu, prirodan završetak reprodukcije i pogrešku medijskog izvora.
Verzija: 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 sučelje web-platforme za audio i video elemente, a ne dio ECMAScripta. Logičko svojstvo media.paused dostupno je samo za čitanje i početno iznosi true. Vrijednost false znači da element nije pauziran, ali ne dokazuje da reprodukcija napreduje: element možda čeka podatke.
play() pokušava pokrenuti ili nastaviti reprodukciju. Vraća obećanje koje se ispunjava kad reprodukcija uspješno započne, a odbija se u slučaju neuspjeha, na primjer uz NotAllowedError kad pravila automatske reprodukcije blokiraju zahtjev. Događaj play stavlja se u red čekanja kad se paused promijeni iz true u false. Razlikuje se od događaja playing, koji označava početak ili nastavak nakon čekanja podataka. pause() vraća undefined i ne uzrokuje novi prijelaz ako je element već pauziran. Događaj pause nastupa nakon prijelaza u stanje pauze.
ended označava završetak reprodukcije, a ne običnu pauzu. Pri prirodnom završetku reprodukcije prema naprijed, pause može prethoditi događaju ended bez poziva metode pause(). Ako vrijedi loop === true i playbackRate nije negativan, ended se ne pokreće. Logičko svojstvo media.ended označava stanje, a ne događaj.
Osluškuj ova četiri događaja izravno na elementu: ne šire se prema gore kroz stablo DOM-a i ne mogu se otkazati. Događaj error označava pogrešku izvora, primjerice pri učitavanju ili dekodiranju. Provjeri media.error: to je MediaError sa svojstvom code, odnosno null ako nije zabilježena pogreška. Odbijanje obećanja iz play() obradi zasebno; sama blokada automatske reprodukcije nije pogreška izvora.
Primjeri
<!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
Spremi primjer kao `media-demo.html` i otvori ga u pregledniku. Otvori konzolu preglednika i klikni `Run media demo`. Očekivani slijed pretpostavlja podršku za PCM WAV, dopuštenje za učitavanje medija s URL-ova `data:` i neprekinutu reprodukciju. Nakon jedne sekunde tišine, prirodan završetak izaziva `pause` prije `ended`; tek potom kôd postavlja namjerno neispravan izvor. Ako se obećanje iz `play()` odbije, provjeri naziv pogreške umjesto da očekuješ cijeli slijed.
Povezane lekcije
- JavaScript · Lekcija 34 · Napredno · Verzija: 4