CKTIS / HTML
onsuspend — обработване на спирането на извличането на медия
Атрибутът onsuspend задава JavaScript кода, който се изпълнява при събитието suspend. При аудио и видео това събитие означава, че браузърът умишлено не извлича данни в момента, а не че възпроизвеждането е поставено на пауза.
Версия: WHATWG HTML Living Standard; index snapshot date recorded separately
Синтаксис
onsuspend="JavaScript statements"onsuspend е глобален атрибут за обработчик на събитието suspend. Стойността му е JavaScript код, а не адрес на ресурс или булева стойност. Макар атрибутът да е достъпен за HTML елементи, обикновено се използва при елементите audio и video.
Браузърът задейства suspend, когато умишлено спре извличането на медийни данни, като задава networkState на NETWORK_IDLE. Например може да изчака възпроизвеждането да започне, преди да изтегли още данни. Само по себе си това не означава грешка или спряно възпроизвеждане: pause се отнася до възпроизвеждането, а stalled — до случая, в който браузърът се опитва да извлича данни, но не ги получава.
В кода на атрибута event предоставя обекта на събитието. В JavaScript вместо това можете да присвоите функция на свойството element.onsuspend или да използвате element.addEventListener('suspend', handler). Името на събитието не включва префикса on.
Примерът задейства синтетично събитие, така че резултатът да не зависи от мрежата или от решенията на браузъра за буфериране. Той проверява само изпълнението на кода на атрибута; не спира извличането и не променя networkState. Политиката за сигурност на страницата може да блокира код за обработка на събития, записан директно в атрибути.
Примери
<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>onsuspend demo</title>
<audio id="media" onsuspend="document.getElementById('result').textContent = event.type"></audio>
<output id="result">pending</output>
<script>
document.getElementById('media').dispatchEvent(new Event('suspend'));
</script>
</html>Резултат
suspend
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.