Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

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

Izvori