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 wurde, unabhängig davon, ob sie erfolgreich (nach load) oder erfolglos (nach abort oder error) beendet wurde.
Das loadend-Ereignis wird auch gesendet, wenn die Anfrage unterbrochen wurde (durch ein timeout, ein abort oder ein error). In solchen Fällen betragen sowohl der loaded- als auch der total-Wert des Ereignisses 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
Neben den unten aufgeführten Eigenschaften sind die Eigenschaften der Elternschnittstelle, Event, verfügbar.
lengthComputableSchreibgeschützt-
Ein boolesches Flag, das angibt, ob die Gesamtarbeit, die vom zugrunde liegenden Prozess zu erledigen ist, und die bereits geleistete Arbeit berechenbar sind. Mit anderen Worten, es sagt aus, ob der Fortschritt messbar ist oder nicht.
loadedSchreibgeschützt-
Ein 64-Bit-Unsigned-Integer-Wert, der die bereits geleistete Arbeit durch den zugrunde liegenden Prozess angibt. Das Verhältnis der geleisteten Arbeit kann berechnet werden, indem
totaldurch den Wert dieser Eigenschaft geteilt wird. Beim Herunterladen einer Ressource über HTTP zählt dies nur den Körper der HTTP-Nachricht und schließt Header und anderen Overhead nicht ein. totalSchreibgeschützt-
Ein 64-Bit-Unsigned-Integer, der die Gesamtmenge der Arbeit darstellt, die der zugrunde liegende Prozess auszuführen hat. Beim Herunterladen einer Ressource über HTTP ist dies die
Content-Length(die Größe des Nachrichtentextes) und schließt die Header und anderen Overhead nicht mit ein.
Beispiele
Verwendung des loadend-Ereignisses
Sie können das loadend-Ereignis verwenden, um die (erfolgreiche oder nicht erfolgreiche) Beendigung eines Uploads zu erkennen. Für ein vollständiges Codebeispiel, das eine Datei hochlädt und einen Fortschrittsbalken 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 |