XMLHttpRequestUpload: timeout-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 timeout-Ereignis wird ausgelöst, wenn der Fortschritt aufgrund der Ablauffrist beendet wird.

Syntax

Verwenden Sie den Ereignisnamen in Methoden wie addEventListener() oder setzen Sie eine Ereignishandler-Eigenschaft.

addEventListener("timeout", (event) => { })

ontimeout = (event) => { }

Ereigniseigenschaften

Zusätzlich zu den unten aufgeführten Eigenschaften sind Eigenschaften der übergeordneten Schnittstelle Event verfügbar.

lengthComputable Schreibgeschützt: Ein boolesches Kennzeichen, das angibt, ob die gesamte zu leistende 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.
loaded Schreibgeschützt: Ein 64-Bit-Integer-Wert ohne Vorzeichen, der die bereits durch den 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 Körper der HTTP-Nachricht und schließt keine Header und anderes Overhead ein.
total Schreibgeschützt: Ein 64-Bit-Integer ohne Vorzeichen, das die gesamte Menge der Arbeit repräsentiert, die der zugrunde liegende Prozess gerade ausführt. Beim Herunterladen einer Ressource über HTTP ist dies die Content-Length (die Größe des Nachrichtentextes) und schließt keine Header und anderes Overhead ein.

Sie können das timeout-Ereignis verwenden, um einen Upload zu erkennen, der gestoppt wurde, weil er zu langsam war. Für ein vollständiges Codebeispiel, das eine Datei hochlädt und eine Fortschrittsanzeige anzeigt, siehe die Hauptseite von XMLHttpRequestUpload.

Das Timeout wird auf dem XMLHttpRequest-Objekt mit der XMLHttpRequest.timeout-Eigenschaft gesetzt.

// In case of an timeout 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("timeout", errorAction);

Spezifikationen

Specification
XMLHttpRequest # event-xhr-timeout
XMLHttpRequest # handler-xhr-ontimeout

Browser-Kompatibilität

Siehe auch

Verwandte Ereignisse: loadstart, load, progress, error, loadend, abort
XMLHttpRequestUpload
XMLHttpRequest.timeout