XMLHttpRequestUpload: error-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 error
-Ereignis wird ausgelöst, wenn die Anfrage auf einen Fehler gestoßen ist.
Syntax
Verwenden Sie den Ereignisnamen in Methoden wie addEventListener()
, oder setzen Sie eine Ereignishandler-Eigenschaft.
addEventListener("error", (event) => { })
onerror = (event) => { }
Ereignistyp
Ein ProgressEvent
. Erbt von Event
.
Ereigniseigenschaften
Neben den unten aufgeführten Eigenschaften sind Eigenschaften von der übergeordneten Schnittstelle, Event
, verfügbar.
lengthComputable
Schreibgeschützt-
Ein boolesches Flag, das angibt, ob die gesamte zu erledigende Arbeit und der bereits geleistete Arbeitsaufwand des zugrunde liegenden Prozesses berechenbar sind. Mit anderen Worten, es gibt an, ob der Fortschritt messbar ist oder nicht.
loaded
Schreibgeschützt-
Ein 64-Bit-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 dividiert wird. Beim Herunterladen einer Ressource mit HTTP zählt dies nur den Körper der HTTP-Nachricht und schließt Header und anderen Overhead nicht ein. total
Schreibgeschützt-
Ein 64-Bit-Integer, das die gesamte Menge der Arbeit repräsentiert, die der zugrunde liegende Prozess gerade durchführt. Beim Herunterladen einer Ressource mit HTTP ist dies die
Content-Length
(die Größe des Nachrichtenkörpers) und schließt die Header und anderen Overhead nicht ein.
Beispiele
Verwendung des error
-Ereignisses
Sie können das error
-Ereignis verwenden, um ein Problem beim Hochladen zu erkennen. Für ein vollständiges Codebeispiel, das eine Datei hochlädt und eine Fortschrittsanzeige anzeigt, siehe die Hauptseite XMLHttpRequestUpload
.
// In case of an error we hide the progress bar
// Note that this event can be listened to on the xhr object too
function errorAction(event) {
progressBar.classList.remove("visible");
log.textContent = `Upload failed: ${event.type}`;
}
xhr.upload.addEventListener("error", errorAction);
Spezifikationen
Specification |
---|
XMLHttpRequest # event-xhr-error |
XMLHttpRequest # handler-xhr-onerror |