KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / JavaScript

HTMLMediaElement: tijd, volume en afspeelgebeurtenissen

HTMLMediaElement biedt de gedeelde API voor audio- en video-elementen. Lees de afspeelstatus uit, wijzig de positie en demping, en werk de interface bij op basis van gebeurtenissen in plaats van aan te nemen dat een afspeelopdracht meteen is geslaagd.

Versie: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Syntax

media.currentTime = seconds; media.volume = 0.5; media.muted = true; media.addEventListener("timeupdate", render);

HTMLMediaElement is de gedeelde interface voor audio- en video-elementen. Het is een Web-API die door HTML wordt gedefinieerd, geen functie van een bepaalde ECMAScript-editie. De aanwezigheid van Node 24 bewijst geen browserondersteuning. De kerninterface is breed beschikbaar, maar volume kent compatibiliteitsbeperkingen; controleer de beoogde browsers en apparaten.

HTMLMediaElement.currentTime geeft de positie in seconden aan. Als readyState de waarde HAVE_NOTHING heeft, zoals bij het element zonder bron in het voorbeeld, slaat een toewijzing de standaardstartpositie voor het afspelen op zonder een sprong te starten. In de andere toestanden vraagt een toewijzing om een sprong binnen de beschikbare tijdlijn. HTMLMediaElement.duration is alleen-lezen: seconden, NaN als er geen gegevens beschikbaar zijn, of Infinity bij een onbepaalde duur. Bereken het voortgangspercentage alleen bij een eindige, positieve duur. HTMLMediaElement.volume accepteert waarden van 0 tot 1. HTMLMediaElement.muted dempt het geluid onafhankelijk, zonder het opgeslagen volume te wijzigen.

De alleen-lezen eigenschappen HTMLMediaElement.paused en HTMLMediaElement.ended geven respectievelijk aan of de media gepauzeerd is en of het afspelen is afgelopen; ze zijn niet uitwisselbaar. paused === false garandeert geen voortgang, bijvoorbeeld tijdens buffering. HTMLMediaElement.error bevat null of een MediaError-object. De gebeurtenissen play en pause melden statuswijzigingen, terwijl de methoden play() en pause() opdrachten geven. Handel afwijzing van de promise van play() af, bijvoorbeeld wanneer het autoplaybeleid het afspelen blokkeert.

loadedmetadata geeft aan dat metadata is geladen, durationchange dat de duur is gewijzigd en emptied dat de resourcestatus is leeggemaakt; werk dan ook de interface bij. Gebruik timeupdate om de positie bij te werken, maar niet als frameklok: de frequentie hangt af van de belasting. volumechange betreft wijzigingen aan volume of muted; ended geeft het einde van het afspelen aan. De gebeurtenis error kan niet alleen een fout bij het laden van de resource melden, maar ook een fatale decoderingsfout nadat het afspelen is begonnen. Lees de actuele eigenschappen uit in gebeurtenisafhandelaars.

Het voorbeeld maakt een element zonder bron, registreert gebeurtenissen en toont de beginstatus. Het speelt geen bestand af en test de decodering niet. NaN wordt bewust als tekst weergegeven, zodat JSON-serialisatie dit onderscheid behoudt.

Voorbeelden

const media = document.createElement("audio");
const events = [
  "timeupdate", "loadedmetadata", "durationchange", "emptied",
  "play", "pause", "volumechange", "ended", "error"
];
function snapshot() {
  return JSON.stringify({
    currentTime: media.currentTime,
    duration: Number.isNaN(media.duration) ? "NaN" : String(media.duration),
    volume: media.volume,
    muted: media.muted,
    paused: media.paused,
    ended: media.ended,
    error: media.error === null ? null : media.error.code
  });
}
for (const type of events) {
  media.addEventListener(type, () => console.log(type, snapshot()));
}
console.log(snapshot());

Resultaat

{"currentTime":0,"duration":"NaN","volume":1,"muted":false,"paused":true,"ended":false,"error":null}

De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.

Bronnen