KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / JavaScript

Gebeurtenissen van HTMLMediaElement

Gebruik negen audio- en videogebeurtenissen om de positie, duur en bediening gesynchroniseerd te houden en een reset, het afspeeleinde of een fout te herkennen.

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

Syntax

media.addEventListener(type, (event) => { /* read event.currentTarget here */ });
// type: "timeupdate" | "loadedmetadata" | "durationchange" | "emptied"
//     | "play" | "pause" | "volumechange" | "ended" | "error"

HTMLMediaElement is de browserinterface die audio- en video-elementen delen, geen onderdeel van ECMAScript. Gebruik addEventListener() rechtstreeks op het media-element, liefst voordat je src instelt: deze gebeurtenissen bubbelen niet naar bovenliggende elementen en kunnen niet worden geannuleerd. Lees in elke handler de actuele toestand van het element in plaats van die uit de gebeurtenisvolgorde af te leiden.

loadedmetadata betekent dat metagegevens zoals de videoafmetingen beschikbaar zijn, niet dat afspelen al mogelijk is. durationchange meldt een vastgestelde of bijgewerkte duur: duration is in seconden, met NaN als er geen gegevens zijn en Infinity als er geen begrensd einde is. emptied betekent dat de toestand van de mediabron is gereset, bijvoorbeeld bij opnieuw laden. Wis dan de oude mediagegevens uit de interface: de reset op zichzelf hoeft geen durationchange te veroorzaken.

Lees bij timeupdate de waarde van currentTime in seconden om de positie-indicator bij te werken. De gebeurtenis kan optreden tijdens afspelen of bij het springen naar een andere positie; het is geen timer met een vaste frequentie of signaal per frame. play betekent dat paused naar false ging, niet dat het afspelen al is begonnen (playing). pause meldt de overgang naar de pauzestand, niet een tijdelijk datatekort. Lees bij volumechange zowel volume als muted: een wijziging van elk van beide kan de gebeurtenis veroorzaken.

ended meldt dat het einde is bereikt, niet een gewone pauze, al kan aan het einde ook pause optreden. Als loop op true staat en playbackRate niet negatief is, treedt ended niet op. Controleer bij error de eigenschap media.error, bijvoorbeeld media.error?.code; dit MediaError-object gaat over de mediabron. Handel afwijzingen van de promise van play() apart af: NotAllowedError kan bijvoorbeeld voortkomen uit het beleid voor automatisch afspelen zonder dat er een mediagebeurtenis error optreedt.

Voorbeelden

<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>HTMLMediaElement events</title>
</head>
<body>
<script>
(() => {
  const panel = document.createElement('div');
  const audio = document.createElement('audio');
  audio.controls = true;
  audio.preload = 'metadata';
  panel.append(audio);

  // Generate three seconds of silence as mono, 8-bit PCM WAV.
  const rate = 8000;
  const samples = 3 * rate;
  const bytes = new Uint8Array(44 + samples);
  const view = new DataView(bytes.buffer);
  const tag = (offset, text) => bytes.set(new TextEncoder().encode(text), offset);
  const u16 = (offset, value) => view.setUint16(offset, value, true);
  const u32 = (offset, value) => view.setUint32(offset, value, true);
  tag(0, 'RIFF'); u32(4, 36 + samples); tag(8, 'WAVE');
  tag(12, 'fmt '); u32(16, 16); u16(20, 1); u16(22, 1);
  u32(24, rate); u32(28, rate); u16(32, 1); u16(34, 8);
  tag(36, 'data'); u32(40, samples); bytes.fill(128, 44);
  const wav = URL.createObjectURL(new Blob([bytes], { type: 'audio/wav' }));
  const bad = URL.createObjectURL(new Blob(['not audio'], { type: 'audio/wav' }));

  const listeners = new AbortController();
  const types = ['timeupdate', 'loadedmetadata', 'durationchange', 'emptied',
    'play', 'pause', 'volumechange', 'ended', 'error'];
  for (const type of types) {
    audio.addEventListener(type, ({ currentTarget: media }) => {
      console.log(type, {
        currentTime: media.currentTime, duration: media.duration,
        paused: media.paused, ended: media.ended,
        volume: media.volume, muted: media.muted,
        errorCode: media.error?.code ?? null
      });
    }, { signal: listeners.signal });
  }

  function button(label, action) {
    const control = document.createElement('button');
    control.type = 'button';
    control.textContent = label;
    control.addEventListener('click', action);
    panel.append(control);
  }
  button('Mute / unmute', () => { audio.muted = !audio.muted; });
  button('Reload', () => { audio.src = wav; });
  button('Load invalid audio', () => { audio.src = bad; });
  button('Remove demo', () => {
    listeners.abort();
    audio.removeAttribute('src');
    audio.load();
    panel.remove();
    URL.revokeObjectURL(wav);
    URL.revokeObjectURL(bad);
  });
  document.body.prepend(panel);
  audio.src = wav;
})();
</script>
</body>
</html>

Resultaat

Expected observations, not a fixed transcript (each event name is logged with a state object):
- Initial load: durationchange and loadedmetadata; duration is 3 seconds at loadedmetadata.
- Play, pause, resume, and let the clip finish: play, timeupdate (repeated), pause, play again, and eventually ended. A pause event can also occur at the end.
- Mute / unmute: volumechange; muted toggles.
- Reload after metadata is available: emptied, then fresh durationchange and loadedmetadata.
- Load invalid audio: error with a non-null errorCode; emptied can appear first.

Sla het voorbeeld op als HTML-bestand en open het in een browser die PCM-WAV ondersteunt en `blob:`-media toestaat. Bekijk de gebeurtenissen in de ontwikkelaarsconsole. Gebruik de ingebouwde bediening om af te spelen en te pauzeren. De demo genereert drie seconden stilte zonder een bestand te downloaden; het tijdstip en het aantal gebeurtenissen kunnen variëren. `Remove demo` verwijdert de bediening en geeft de object-URL’s vrij.

Gerelateerde lessen

  • JavaScript · Les 28 · Gemiddeld · Versie: 3

Bronnen