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 Infinitypaused, 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