CKTIS / HTML
oncanplaythrough — geschatte mediagereedheid afhandelen
Het oncanplaythrough-attribuut bevat JavaScript dat de canplaythrough-gebeurtenis afhandelt. Bij audio en video geeft deze gebeurtenis aan dat afspelen tot het einde zonder verder bufferen naar verwachting mogelijk is, maar het is geen garantie voor ononderbroken afspelen.
Versie: WHATWG HTML Living Standard; index snapshot date recorded separately
Syntax
<audio oncanplaythrough="/* JavaScript */"></audio>
<video oncanplaythrough="/* JavaScript */"></video>oncanplaythrough is een gebeurtenisafhandelingsattribuut voor canplaythrough. De waarde is JavaScript-code, geen booleaanse waarde. Het wordt meestal gebruikt bij audio- en video-elementen; de handlercode kan het object event gebruiken.
De browser zet canplaythrough in de wachtrij wanneer readyState verandert in HAVE_ENOUGH_DATA (4). Meestal betekent dit dat de browser verwacht dat afspelen bij de huidige playbackRate het einde kan bereiken zonder verder bufferen. Deze status omvat ook situaties waarin langer wachten geen extra gegevens oplevert. Het is geen garantie en bevestigt niet dat het hele bestand is gedownload. canplay geeft een lager niveau van gereedheid aan: de mogelijkheid om het afspelen te starten of te hervatten.
Verwar de attribuutnaam oncanplaythrough niet met de gebeurtenisnaam canplaythrough. Alternatieven zijn een functie toewijzen aan de eigenschap element.oncanplaythrough en element.addEventListener('canplaythrough', handler) gebruiken. Het attribuut bevat code, terwijl de eigenschap een functie krijgt toegewezen.
Het voorbeeld verstuurt bewust een synthetische gebeurtenis, zodat voor de controle geen mediabestand of netwerkverbinding nodig is. De verwachte tekst van de alinea is canplaythrough; deze test controleert alleen of de handler is gekoppeld, niet of de media werkelijk gereed zijn.
Voorbeelden
<!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>Resultaat
canplaythrough
De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.