CKTIS / HTML
onwaiting — обработване на изчакването на медийни данни
Атрибутът onwaiting задава кода, който се изпълнява при събитието waiting. При елементите audio и video това събитие показва, че възпроизвеждането не може да продължи поради липса на достатъчно данни. Самият атрибут не започва изтегляне или възпроизвеждане.
Версия: WHATWG HTML Living Standard; index snapshot date recorded separately
Синтаксис
onwaiting="JavaScript statements"
media.onwaiting = (event) => { /* handle waiting */ };onwaiting е атрибут за обработване на събитието waiting. Стойността му в HTML е JavaScript код, а не булева стойност. Достъпен е за всички HTML елементи, но обикновено се използва с елементите audio и video. Съответстващото свойство в JavaScript е onwaiting.
Събитието waiting показва, че възпроизвеждането не може да продължи, защото данните, необходими за следващата стъпка, не са налични. То може да възникне при започване на възпроизвеждането или след изчерпване на буфера. Само по себе си не означава постоянна грешка или загубена мрежова връзка. Не го бъркайте със stalled, което се отнася до липса на пристигащи данни, докато браузърът се опитва да ги извлече.
Обработчикът може да показва индикатор за изчакване; събитието playing позволява реакция при започване или подновяване на възпроизвеждането. Естествено събитие waiting не се разпространява нагоре и не може да бъде отменено, затова return false няма да поднови възпроизвеждането. Задаването на функция на media.onwaiting заменя предишния обработчик на това свойство; addEventListener('waiting', handler) позволява регистрирането на независими слушатели.
Примерът умишлено изпраща синтетично събитие, така че резултатът да не зависи от медиен файл или мрежата. Текстът на абзаца би трябвало да се промени от idle на waiting. Тестът проверява само свързването на обработчика: не предизвиква реално буфериране и не променя състоянието на възпроизвеждане. Политиката за сигурност на страницата може да блокира скриптове и обработчици на събития, записани директно в HTML.
Примери
<!doctype html>
<meta charset="utf-8">
<title>onwaiting demo</title>
<video id="media" onwaiting="document.getElementById('status').textContent = event.type"></video>
<p id="status">idle</p>
<script>
const media = document.getElementById('media');
media.dispatchEvent(new Event('waiting'));
</script>Резултат
waiting
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.