CKTIS / HTML
oncanplaythrough — geschätzte Medienbereitschaft behandeln
Das Attribut oncanplaythrough enthält JavaScript zur Behandlung des Ereignisses canplaythrough. Bei Audio und Video signalisiert es die geschätzte Möglichkeit, bis zum Ende ohne weiteres Puffern abzuspielen, ist aber keine Garantie für eine ununterbrochene Wiedergabe.
Version: WHATWG HTML Living Standard; index snapshot date recorded separately
Syntax
<audio oncanplaythrough="/* JavaScript */"></audio>
<video oncanplaythrough="/* JavaScript */"></video>oncanplaythrough ist ein Ereignisbehandlungsattribut für canplaythrough. Sein Wert ist JavaScript-Code, kein boolescher Wert. Typische Einsatzbereiche sind audio- und video-Elemente; im Handler-Code ist das Objekt event verfügbar.
Der Browser stellt canplaythrough in die Ereigniswarteschlange, wenn readyState zu HAVE_ENOUGH_DATA (4) wechselt. Das bedeutet normalerweise, dass er davon ausgeht, die Wiedergabe könne bei der aktuellen playbackRate ohne weiteres Puffern bis zum Ende laufen. Dieser Zustand umfasst auch Fälle, in denen längeres Warten keine zusätzlichen Daten liefert. Er ist weder eine Garantie noch eine Bestätigung dafür, dass die gesamte Datei heruntergeladen wurde. canplay bezeichnet eine geringere Bereitschaftsstufe: die Möglichkeit, die Wiedergabe zu starten oder fortzusetzen.
Verwechsle den Attributnamen oncanplaythrough nicht mit dem Ereignisnamen canplaythrough. Alternativen sind, eine Funktion der Eigenschaft element.oncanplaythrough zuzuweisen oder element.addEventListener('canplaythrough', handler) zu verwenden. Das Attribut enthält Code, während der Eigenschaft eine Funktion zugewiesen wird.
Das Beispiel löst absichtlich ein synthetisches Ereignis aus, sodass für die Überprüfung weder eine Mediendatei noch eine Netzwerkverbindung erforderlich ist. Der erwartete Absatztext lautet canplaythrough; damit wird nur die Verknüpfung des Handlers getestet, nicht die tatsächliche Medienbereitschaft.
Beispiele
<!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>Ergebnis
canplaythrough
Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.