База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / JavaScript

Състояние и време на възпроизвеждане: paused, muted, currentTime и duration

Проверявайте поотделно паузата и заглушаването, задавайте позиция на възпроизвеждане в секунди и различавайте известната продължителност от `NaN` и `Infinity`.

Версия: ECMAScript 2024 and the current web platform; runtime support varies

Синтаксис

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 и duration са свойства на екземпляри на HTMLMediaElement, достъпни за елементите audio и video. Те са част от уеб платформата, а не от самия ECMAScript, затова не разчитайте на тях в среда без DOM.

paused е булева стойност само за четене. Нов елемент започва с paused === true. Извиквайте pause() и play(), вместо да присвоявате стойност на paused. Обещанието, което play() връща, може да бъде отхвърлено, например ако браузърът блокира автоматичното възпроизвеждане. paused === false не гарантира, че позицията напредва: елементът може да чака данни.

muted е булева стойност за четене и запис, която показва дали звукът е заглушен в момента. media.muted = true заглушава звуковия изход, а false отменя заглушаването. Заглушаването не е нито пауза, нито задаване на volume на нула. defaultMuted отразява HTML атрибута muted, който определя състоянието на заглушаване по подразбиране, а не текущото състояние.

currentTime връща позицията на възпроизвеждане по времевата ос на медията в секунди, включително части от секундата. Преди метаданните да са налични, присвояването запазва заявената начална позиция; след това то започва преместване до друга позиция. NaN и безкрайните стойности предизвикват TypeError. Действителната позиция може да се различава от заявената: проверявайте диапазоните в seekable, особено при предавания на живо, и използвайте seeked, за да установите кога преместването е приключило.

duration е само за четене. Крайна числова стойност показва момента на края в секунди по времевата ос на медията, тоест продължителността, ако оста започва от нула. NaN означава, че продължителността още не е налична; Infinity означава, че медията няма известен край. Прочетете стойността при loadedmetadata и я обновявайте при durationchange. За ос, която започва от нула, пресмятайте currentTime / duration само ако е изпълнено Number.isFinite(duration) && duration > 0.

Примери

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

Резултат

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

Запазете примера като HTML файл, отворете го в браузър и проверете изхода в конзолата. Елементът няма източник: `2.5` е запазената начална позиция, а не резултат от преместване или възпроизвеждане. Елементът остава на пауза, а `duration` остава `NaN`.

Свързани уроци

  • JavaScript · Урок 28 · Средно · Версия: 3

Източници