База знанияИзпитен център
BGБългарски
Избери език13

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

Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.

Източници