XMLHttpRequestUpload: loadend Ereignis
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 loadend Ereignis wird ausgelöst, wenn eine Anfrage abgeschlossen ist, unabhängig davon, ob sie erfolgreich (nach load) oder erfolglos (nach abort oder error) war.
Das loadend Ereignis wird auch gesendet, wenn die Anfrage unterbrochen wurde (durch einen timeout, einen abort oder einen error). In solchen Fällen haben sowohl der loaded als auch der total Wert des Ereignisses den Wert 0.
Syntax
Verwenden Sie den Ereignisnamen in Methoden wie addEventListener() oder setzen Sie eine Ereignis-Handler-Eigenschaft.
addEventListener("loadend", (event) => {});
onloadend = (event) => {};
Ereignistyp
Ein ProgressEvent. Erbt von Event.
Ereigniseigenschaften
Zusätzlich zu den unten aufgelisteten Eigenschaften sind Eigenschaften der übergeordneten Schnittstelle, Event, verfügbar.
lengthComputableSchreibgeschützt-
Ein boolesches Flag, das anzeigt, ob die gesamte zu erledigende Arbeit und die bereits geleistete Arbeit durch den zugrunde liegenden Prozess berechenbar sind. Mit anderen Worten, es zeigt an, ob der Fortschritt messbar ist oder nicht.
loadedSchreibgeschützt-
Ein 64-Bit-Unsigned-Integer-Wert, der die bereits durch den zugrunde liegenden Prozess geleistete Arbeit angibt. Das Verhältnis der geleisteten Arbeit kann berechnet werden, indem
totaldurch den Wert dieser Eigenschaft geteilt wird. Beim Herunterladen einer Ressource mittels HTTP zählt dies nur den Hauptteil der HTTP-Nachricht und beinhaltet nicht Header und anderen Overhead. totalSchreibgeschützt-
Ein 64-Bit-Unsigned-Integer-Wert, der die Gesamtarbeit repräsentiert, die der zugrunde liegende Prozess zu leisten hat. Beim Herunterladen einer Ressource mittels HTTP ist dies die
Content-Length(die Größe des Hauptteils der Nachricht) und beinhaltet nicht die Header und anderen Overhead.
Beispiele
Verwendung des loadend Ereignisses
Sie können das loadend Ereignis verwenden, um das (erfolgreiche oder nicht) Ende eines Uploads zu erkennen. Für ein vollständiges Codebeispiel, das eine Datei hochlädt und eine Fortschrittsanzeige anzeigt, siehe die Hauptseite XMLHttpRequestUpload.
// When the upload is finished, we hide the progress bar.
xhr.upload.addEventListener("loadend", (event) => {
progressBar.classList.remove("visible");
if (event.loaded !== 0) {
// Successful termination
log.textContent = "Upload finished.";
}
abortButton.disabled = true;
});
Spezifikationen
| Specification |
|---|
| XMLHttpRequest # event-xhr-loadend |
| XMLHttpRequest # handler-xhr-onloadend |