Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

Stan i czas odtwarzania: paused, muted, currentTime i duration

Sprawdzaj osobno stan pauzy i wyciszenia, ustawiaj pozycję na osi czasu w sekundach i odróżniaj znany czas trwania od wartości `NaN` i `Infinity`.

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

Składnia

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 i duration to właściwości instancji HTMLMediaElement, dostępne na elementach audio i video. Należą do API platformy webowej, a nie do samego ECMAScriptu, więc nie zakładaj ich dostępności w środowisku bez DOM.

paused to właściwość logiczna tylko do odczytu. Nowy element ma paused === true. Używaj pause() i play(), zamiast przypisywać wartość do paused. Obietnica zwracana przez play() może zostać odrzucona, na przykład gdy przeglądarka blokuje automatyczne odtwarzanie. Samo paused === false nie oznacza, że pozycja się zmienia: element może czekać na dane.

muted to logiczny stan wyciszenia dźwięku, który można odczytywać i zmieniać. media.muted = true wycisza dźwięk, a false wyłącza wyciszenie. Wyciszenie nie jest pauzą ani ustawieniem volume na zero. defaultMuted odzwierciedla atrybut HTML muted, który określa domyślne wyciszenie, a nie bieżący stan.

currentTime odczytuje pozycję na osi czasu medium w sekundach; ułamki sekund są dozwolone. Przed dostępnością metadanych przypisanie zapisuje żądaną pozycję początkową. Po ich załadowaniu przypisanie inicjuje przewinięcie. NaN i wartości nieskończone powodują TypeError. Faktyczna pozycja może różnić się od żądanej: sprawdź zakresy seekable, zwłaszcza w transmisji na żywo, i użyj zdarzenia seeked, aby wykryć zakończenie przewijania.

duration jest tylko do odczytu: skończona wartość to czas końca na osi czasu medium w sekundach (długość, jeśli oś zaczyna się od zera). NaN oznacza, że czas trwania nie jest jeszcze dostępny, a Infinity — że medium nie ma znanego końca. Odczytaj tę wartość przy loadedmetadata i odświeżaj ją przy durationchange. Dla osi zaczynającej się od zera obliczaj currentTime / duration tylko wtedy, gdy Number.isFinite(duration) && duration > 0.

Przykłady

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

Wynik

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

Zapisz przykład jako plik HTML, otwórz go w przeglądarce i sprawdź wynik w konsoli. Element nie ma źródła: `2.5` to zapisana pozycja początkowa, a nie wynik przewinięcia ani odtwarzania. Element nadal jest w stanie pauzy, a `duration` pozostaje `NaN`.

Powiązane lekcje

  • JavaScript · Lekcja 28 · Średniozaawansowany · Wersja: 3

Źródła