CKTIS / HTML
onstalled — обработване на блокирало изтегляне на мултимедия
Атрибутът onstalled задава кода, който се изпълнява при събитието stalled, когато браузърът се опитва да получи мултимедийни данни, но такива не пристигат. Това се отнася до изтеглянето, а не непременно до прекъсване на възпроизвеждането.
Версия: WHATWG HTML Living Standard; index snapshot date recorded separately
Синтаксис
HTML: onstalled="JavaScript statements"
JavaScript: media.onstalled = handler;
Alternative: media.addEventListener("stalled", handler);onstalled е атрибут за обработчик на събитието stalled. Той е достъпен като глобален HTML атрибут, но браузърът обикновено изпраща това събитие към мултимедийните елементи audio и video. Стойността му съдържа JavaScript инструкции, а не адрес на ресурс или булева стойност.
Събитието възниква, когато даден елемент активно се опитва да получи мултимедийни данни, но не получава такива в рамките на времето, определено от механизма за откриване на блокиране. Това не означава автоматично грешка или прекъснато възпроизвеждане: буферираните данни може да позволят възпроизвеждането да продължи. waiting се отнася до възпроизвеждане, което чака данни, докато suspend означава, че браузърът е спрял получаването.
В HTML използвайте onstalled="..."; в JavaScript присвоете функция на media.onstalled. Присвояването заменя предишния обработчик в този слот. Алтернативата media.addEventListener("stalled", handler) регистрира независими слушатели. Не вмъквайте недоверен текст в кода на атрибута; Content Security Policy може да блокира вградените обработчици.
Примерът изпраща синтетично събитие, за да провери детерминистично свързването на атрибута. Той не изтегля файл и не симулира действителното състояние на мрежата или буфера. Очакваният текст в абзаца е stalled.
Примери
<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>onstalled demonstration</title>
<audio id="media" onstalled="document.getElementById('status').textContent = event.type"></audio>
<p id="status">pending</p>
<script>
const media = document.getElementById('media');
media.dispatchEvent(new Event('stalled'));
</script>
</html>Резултат
stalled
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.