XMLHttpRequestUpload: load-Event
Baseline Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.
Hinweis: Diese Funktion ist in Web Workers verfügbar, mit Ausnahme von Service Workers.
Das load
-Event wird ausgelöst, wenn eine XMLHttpRequestUpload
-Transaktion erfolgreich abgeschlossen wird.
Syntax
Verwenden Sie den Event-Namen in Methoden wie addEventListener()
oder setzen Sie eine Event-Handler-Eigenschaft.
addEventListener("load", (event) => { })
onload = (event) => { }
Event-Typ
Ein ProgressEvent
. Erbt von Event
.
Event-Eigenschaften
Zusätzlich zu den unten aufgeführten Eigenschaften sind die Eigenschaften der übergeordneten Schnittstelle, Event
, verfügbar.
lengthComputable
Schreibgeschützt-
Ein boolesches Flag, das angibt, ob die gesamte zu erledigende Arbeit und die bereits geleistete Arbeit vom zugrunde liegenden Prozess berechenbar ist. Mit anderen Worten, es zeigt an, ob der Fortschritt messbar ist oder nicht.
loaded
Schreibgeschützt-
Ein 64-Bit-Unsigned-Integer-Wert, der die bereits vom zugrunde liegenden Prozess geleistete Arbeit angibt. Das Verhältnis der geleisteten Arbeit kann berechnet werden, indem
total
durch den Wert dieser Eigenschaft geteilt wird. Beim Herunterladen einer Ressource über HTTP zählt dies nur den Hauptteil der HTTP-Nachricht und schließt Header und andere Overheads aus. total
Schreibgeschützt-
Ein 64-Bit-Unsigned-Integer-Wert, der die gesamte Menge der Arbeit repräsentiert, die der zugrunde liegende Prozess ausführt. Beim Herunterladen einer Ressource über HTTP ist dies die
Content-Length
(die Größe des Hauptteils der Nachricht) und schließt die Header und andere Overheads aus.
Beispiele
Verwendung des load
-Events
Sie können das load
-Event verwenden, um das erfolgreiche Ende eines Uploads zu erkennen. Für ein vollständiges Codebeispiel, das eine Datei hochlädt und eine Fortschrittsleiste anzeigt, siehe die Hauptseite von XMLHttpRequestUpload
.
// When the upload is finished, we hide the progress bar.
xhr.upload.addEventListener("load", (event) => {
progressBar.classList.remove("visible");
log.textContent = "Upload finished.";
abortButton.disabled = true;
});
Spezifikationen
Specification |
---|
XMLHttpRequest # event-xhr-load |
XMLHttpRequest # handler-xhr-onload |