CKTIS / HTML
oncanplaythrough — обработване на предполагаемата готовност на медията
Атрибутът oncanplaythrough съдържа JavaScript код за обработване на събитието canplaythrough. При аудио и видео то показва предполагаема възможност за възпроизвеждане до края без допълнително буфериране, но не гарантира непрекъснато възпроизвеждане.
Версия: WHATWG HTML Living Standard; index snapshot date recorded separately
Синтаксис
<audio oncanplaythrough="/* JavaScript */"></audio>
<video oncanplaythrough="/* JavaScript */"></video>oncanplaythrough е атрибут за обработване на събитието canplaythrough. Стойността му е JavaScript код, а не булева стойност. Обикновено се използва с елементите audio и video; кодът на обработчика може да достъпва обекта event.
Браузърът поставя canplaythrough на опашка, когато readyState се промени на HAVE_ENOUGH_DATA (4). Обикновено това означава, че според преценката му възпроизвеждането при текущата стойност на playbackRate може да стигне до края без допълнително буфериране. Това състояние обхваща и случаите, в които по-дългото изчакване не би осигурило повече данни. То не гарантира и не потвърждава, че целият файл е изтеглен. canplay показва по-ниска степен на готовност: възможност за започване или подновяване на възпроизвеждането.
Не бъркайте името на атрибута oncanplaythrough с името на събитието canplaythrough. Други възможности са да присвоите функция на свойството element.oncanplaythrough или да използвате element.addEventListener('canplaythrough', handler). Атрибутът съдържа код, а на свойството се присвоява функция.
Примерът умишлено задейства синтетично събитие, така че проверката не изисква нито медиен файл, нито мрежова връзка. Очакваният текст в абзаца е canplaythrough; този тест проверява само свързването на обработчика, а не действителната готовност на медията.
Примери
<!doctype html>
<meta charset="utf-8">
<title>oncanplaythrough test</title>
<audio id="media" oncanplaythrough="document.getElementById('status').textContent = event.type"></audio>
<p id="status">Pending</p>
<script>
const media = document.getElementById('media');
media.dispatchEvent(new Event('canplaythrough'));
</script>Резултат
canplaythrough
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.