WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / HTML

onprogress — Ereignisse zum Downloadfortschritt behandeln

Das Attribut onprogress enthält JavaScript-Code zur Behandlung des progress-Ereignisses. Bei audio- und video-Elementen betrifft es das Herunterladen von Mediendaten, nicht den Ablauf der Wiedergabezeit.

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

Syntax

onprogress="JavaScript statements"
element.onprogress = handler;
element.addEventListener("progress", handler);

onprogress ist ein Event-Handler-Attribut für progress. Es ist auf allen HTML-Elementen verfügbar, doch allein seine Anwesenheit startet weder einen Download noch löst sie Ereignisse aus. Die zugehörige JavaScript-Eigenschaft ist auch auf Document- und Window-Objekten verfügbar.

Bei audio und video meldet progress das Herunterladen von Mediendaten. Es bedeutet weder Wiedergabefortschritt noch liefert es automatisch einen Prozentsatz der heruntergeladenen Bytes. Das Medienereignis verwendet die Schnittstelle Event, nicht ProgressEvent; gehe nicht davon aus, dass loaded und total verfügbar sind.

Der Attributwert ist JavaScript-Code, in dem event auf das Ereignis verweist. Alternativ kannst du eine Funktion element.onprogress zuweisen oder element.addEventListener("progress", handler) verwenden. Die Zuweisung an die Eigenschaft ersetzt den bisherigen Handler dieses Mechanismus; mit addEventListener() lassen sich unabhängige Listener registrieren.

Das Beispiel löst ausdrücklich ein synthetisches progress-Ereignis aus, daher hängt das Ergebnis nicht vom Netzwerk ab. Es prüft die Behandlung des Attributs, nicht den tatsächlichen Downloadfortschritt. Die Content Security Policy kann Inline-Event-Handler und Inline-Skripte blockieren.

Beispiele

<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>onprogress demo</title>
<body>
<audio id="media" onprogress="document.getElementById('result').textContent = event.type"></audio>
<p id="result">waiting</p>
<script>
  document.getElementById('media').dispatchEvent(new Event('progress'));
</script>
</body>
</html>

Ergebnis

progress

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