KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / JavaScript

HTMLMediaElement: `paused` en de events `play`, `pause`, `ended` en `error`

Onderscheid de huidige afspeelstatus van events en van het resultaat van `play()`. Herken een pauze, het natuurlijke afspeeleinde en een fout in de mediabron.

Versie: ECMAScript 2024 and the current web platform; runtime support varies

Syntax

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 is de interface van het webplatform voor audio- en video-elementen en maakt geen deel uit van ECMAScript. De alleen-lezen booleaanse eigenschap media.paused begint op true. De waarde false betekent dat het element niet gepauzeerd is, maar bewijst niet dat het afspelen vordert: het element kan op gegevens wachten.

play() probeert het afspelen te starten of te hervatten. Het retourneert een promise die wordt vervuld zodra het afspelen met succes begint of die wordt afgewezen bij een fout, bijvoorbeeld met NotAllowedError als het autoplaybeleid het verzoek blokkeert. Het event play wordt in de wachtrij gezet wanneer paused van true in false verandert. Dat is niet hetzelfde als playing, dat een start of hervatting na het wachten op gegevens aangeeft. pause() retourneert undefined en veroorzaakt geen nieuwe overgang als het element al gepauzeerd is. Het event pause wordt afgevuurd nadat het element in de pauzestand is gekomen.

ended geeft het einde van het afspelen aan, niet een gewone pauze. Aan het natuurlijke einde van voorwaarts afspelen kan pause zonder aanroep van pause() vóór ended komen. ended wordt niet afgevuurd als loop === true en playbackRate niet-negatief is. De booleaanse waarde media.ended is een status, geen event.

Registreer listeners voor deze vier events rechtstreeks op het element: ze bubbelen niet door de DOM en kunnen niet worden geannuleerd. Het event error meldt een probleem met de bron, bijvoorbeeld bij het laden of decoderen. Bekijk media.error: dit is een MediaError met code, of null als er geen fout is vastgelegd. Handel een afwijzing van play() apart af; alleen een autoplayblokkade is geen bronfout.

Voorbeelden

<!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>

Resultaat

paused=true
play: paused=false
pause: paused=true
ended: ended=true
error: code=4

Sla het voorbeeld op als `media-demo.html` en open het in een browser. Open de browserconsole en klik op `Run media demo`. De verwachte volgorde gaat uit van ondersteuning voor PCM-WAV, toestemming voor `data:`-URL’s voor media en ononderbroken afspelen. Na één seconde stilte komt bij het natuurlijke einde eerst `pause` en dan `ended`. Pas daarna stelt de code een opzettelijk ongeldige bron in. Wordt `play()` afgewezen, bekijk dan de foutnaam in plaats van de volledige volgorde te verwachten.

Gerelateerde lessen

  • JavaScript · Les 34 · Gevorderd · Versie: 4

Bronnen