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.

js
addEventListener("error", (event) => { })

onerror = (event) => { }

Ereignistyp

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.

js
// 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

Browser-Kompatibilität

Siehe auch