XMLHttpRequest: 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 Verlauf aufgrund des Ablaufs einer voreingestellten Zeit unterbrochen wird.
Syntax
Verwenden Sie den Ereignisnamen in Methoden wie addEventListener()
oder setzen Sie eine Ereignis-Handler-Eigenschaft.
addEventListener("timeout", (event) => { })
ontimeout = (event) => { }
Ereignistyp
Ein ProgressEvent
. Erbt von Event
.
Ereigniseigenschaften
Zusätzlich zu den unten aufgeführten Eigenschaften sind die Eigenschaften von der übergeordneten Schnittstelle, Event
, verfügbar.
lengthComputable
Schreibgeschützt-
Ein boolesches Flag, das angibt, ob die gesamte Arbeit, die zu erledigen ist, und die bereits vom zugrunde liegenden Prozess geleistete Arbeit berechenbar sind. Mit anderen Worten, es wird angezeigt, ob der Fortschritt messbar ist oder nicht.
loaded
Schreibgeschützt-
Ein 64-Bit-Unsigned-Integer-Wert, der die bereits vom zugrunde liegenden Prozess geleistete Arbeit angibt. Der Anteil der geleisteten Arbeit kann berechnet werden, indem der Wert dieser Eigenschaft durch
total
geteilt wird. Beim Herunterladen einer Ressource über HTTP zählt dies nur den Hauptteil der HTTP-Nachricht und schließt Header und anderen Overhead aus. total
Schreibgeschützt-
Ein 64-Bit-Unsigned-Integer, der die Gesamtmenge an Arbeit darstellt, die der zugrunde liegende Prozess gerade ausführt. Beim Herunterladen einer Ressource über HTTP ist dies die
Content-Length
(die Größe des Hauptteils der Nachricht) und schließt Header und anderen Overhead aus.
Beispiele
const client = new XMLHttpRequest();
client.open("GET", "http://www.example.org/example.txt");
client.ontimeout = () => {
console.error("Timeout!!");
};
client.send();
Sie könnten den Ereignis-Handler auch mit der Methode addEventListener()
einrichten:
client.addEventListener("timeout", () => {
console.error("Timeout!!");
});
Spezifikationen
Specification |
---|
XMLHttpRequest # event-xhr-timeout |
XMLHttpRequest # handler-xhr-ontimeout |