ProgressEvent: total-Eigenschaft
Baseline
Weitgehend verfügbar
Diese Funktion ist gut etabliert und funktioniert auf vielen Geräten und in vielen Browserversionen. Sie ist seit Juli 2015 browserübergreifend verfügbar.
Hinweis: Diese Funktion ist in Web Workers verfügbar.
Die ProgressEvent.total-Eigenschaft ist eine Nur-Lese-Eigenschaft, die eine Zahl angibt, die die Gesamtgröße der übertragenen oder verarbeiteten Daten darstellt.
Für vom Browser ausgelöste ProgressEvents bezieht sich der Wert auf die Größe einer Ressource in Bytes und wird aus dem Content-Length Antwort-Header abgeleitet.
In einem ProgressEvent, das Sie selbst erstellen, kann dies auch die Gesamtanzahl von Bytes einer Ressource sein, dies kann jedoch jede beliebige Zahl sein.
Beispielsweise möchten Sie total auf einen Wert wie 100 oder 1 normalisieren, wenn es Ihnen wichtig ist, die genaue Anzahl der Bytes einer Ressource nicht offenzulegen.
Wenn Sie 1 als Gesamtwert verwenden, wäre ProgressEvent.loaded ein Dezimalwert zwischen 0 und 1.
Wenn die lengthComputable-Eigenschaft des Ereignisses false ist, ist dieser Wert bedeutungslos und sollte ignoriert werden.
Wert
Eine Zahl.
Spezifikationen
| Spezifikation |
|---|
| XMLHttpRequest # dom-progressevent-total |
Browser-Kompatibilität
Siehe auch
- Die
ProgressEventSchnittstelle, zu der es gehört.