WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / HTML

oncanplay – Bereitschaft von Medien zur Wiedergabe behandeln

Das Attribut oncanplay enthält JavaScript, das beim Ereignis canplay ausgeführt wird. Bei Audio und Video signalisiert es, dass die Wiedergabe gestartet oder fortgesetzt werden kann. Es garantiert jedoch nicht, dass die gesamte Ressource ohne Unterbrechungen durch Puffern abgespielt werden kann.

Version: WHATWG HTML Living Standard; index snapshot date recorded separately

Syntax

<audio oncanplay="handler(event)"></audio>
<video oncanplay="handler(event)"></video>

oncanplay ist ein Event-Handler-Inhaltsattribut für canplay. Sein Wert ist JavaScript-Code; im Handler steht das Objekt event zur Verfügung. Das Attribut ist auf allen HTML-Elementen zulässig, wird aber typischerweise verwendet, um auf die Wiedergabebereitschaft von audio- und video-Elementen zu reagieren.

Der Browser löst canplay aus, wenn der Medienbereitschaftsstatus von einer niedrigeren Stufe auf HAVE_FUTURE_DATA oder höher wechselt. Dann sind Daten verfügbar, mit denen die Wiedergabe fortgesetzt werden kann, aber nicht unbedingt genug, um die gesamte Ressource ohne Puffern abzuspielen. canplaythrough zeigt dagegen an, dass die geschätzte Möglichkeit besteht, die Wiedergabe bis zum Ende ohne Unterbrechung zum Puffern fortzusetzen. canplay allein bedeutet nicht, dass die Wiedergabe bereits läuft.

Verwenden Sie in HTML oncanplay="handler(event)"; in JavaScript können Sie eine Funktion media.oncanplay zuweisen oder media.addEventListener('canplay', handler) aufrufen. Der Ereignisname enthält nicht das Präfix on. Das Beispiel löst ein synthetisches Ereignis aus: Es prüft die Verbindung zwischen dem Attribut und seinem Handler, nicht die tatsächliche Medienbereitschaft.

Beispiele

<!doctype html>
<meta charset="utf-8">
<title>oncanplay demo</title>
<audio id="media" oncanplay="document.getElementById('result').textContent = event.type"></audio>
<pre id="result">waiting</pre>
<script>
  const media = document.getElementById('media');
  media.dispatchEvent(new Event('canplay'));
</script>

Ergebnis

canplay

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.

Quellen