KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / JavaScript

Afspeelstatus en mediatijd: paused, muted, currentTime en duration

Lees de pauzestatus en demping apart uit, stel de afspeelpositie in seconden in en onderscheid een bekende duur van `NaN` en `Infinity`.

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

Syntax

media.paused              // boolean, read-only
media.muted               // boolean, read/write
media.muted = true        // mute the audio output
media.currentTime         // number in seconds, read/write
media.currentTime = 12.5  // request a position on the media timeline
media.duration            // number in seconds, read-only; may be NaN or Infinity

paused, muted, currentTime en duration zijn instantie-eigenschappen van HTMLMediaElement op audio- en video-elementen. Ze horen bij het webplatform, niet bij ECMAScript zelf. Ga er dus niet van uit dat ze beschikbaar zijn in een omgeving zonder DOM.

paused is een alleen-lezen boolean. Een nieuw element begint met paused === true. Roep pause() en play() aan in plaats van een waarde aan paused toe te kennen. De promise die play() teruggeeft, kan worden afgewezen, bijvoorbeeld als de browser automatisch afspelen blokkeert. paused === false garandeert niet dat de afspeelpositie vordert: het element kan op gegevens wachten.

muted is een leesbare en schrijfbare boolean voor de huidige dempingsstatus. Met media.muted = true demp je het geluid; met false hef je die demping op. Dempen is niet hetzelfde als pauzeren of volume op nul zetten. defaultMuted weerspiegelt het HTML-attribuut muted, dat de standaarddemping aangeeft, niet de huidige toestand.

currentTime geeft de afspeelpositie op de mediatijdlijn in seconden, ook in fracties van een seconde. Voordat metadata beschikbaar zijn, slaat een toekenning de gewenste startpositie op; daarna start die een sprong naar een andere positie. NaN en oneindige waarden veroorzaken een TypeError. De werkelijke positie kan afwijken van de gevraagde positie: controleer de bereiken in seekable, vooral bij livestreams, en gebruik seeked om vast te stellen wanneer de sprong is voltooid.

duration is alleen-lezen. Een eindige waarde is het eindtijdstip op de mediatijdlijn in seconden, dus de speelduur als die tijdlijn bij nul begint. NaN betekent dat de duur nog niet beschikbaar is; Infinity betekent dat het eindpunt niet bekend is. Lees de waarde bij loadedmetadata en werk die bij op durationchange. Bereken op een tijdlijn die bij nul begint currentTime / duration alleen als Number.isFinite(duration) && duration > 0.

Voorbeelden

<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>Media playback state and time</title>
</head>
<body>
  <script>
    const media = document.createElement("video");
    console.log(`currentTime=${media.currentTime}`);

    media.muted = true;
    media.currentTime = 2.5;

    console.log(
      `paused=${media.paused}, muted=${media.muted}, ` +
      `currentTime=${media.currentTime}, duration=${media.duration}`
    );
  </script>
</body>
</html>

Resultaat

currentTime=0
paused=true, muted=true, currentTime=2.5, duration=NaN

Sla het voorbeeld op als HTML-bestand, open het in een browser en bekijk de uitvoer in de browserconsole. Het element heeft geen mediabron: `2.5` is de opgeslagen startpositie, niet het resultaat van een sprong of van afspelen. Het element blijft gepauzeerd en `duration` blijft `NaN`.

Gerelateerde lessen

  • JavaScript · Les 28 · Gemiddeld · Versie: 3

Bronnen