XMLHttpRequest: timeout-Eigenschaft
Baseline
Weitgehend verfügbar
Diese Funktion ist gut etabliert und funktioniert auf vielen Geräten und in vielen Browserversionen. Sie ist seit Juli 2015 browserübergreifend verfügbar.
Hinweis: Diese Funktion ist in Web Workers verfügbar, mit Ausnahme von Service Workers.
Die XMLHttpRequest.timeout-Eigenschaft ist ein unsigned long, der die Anzahl der Millisekunden repräsentiert, die eine Anfrage dauern kann, bevor sie automatisch beendet wird. Der Standardwert ist 0, was bedeutet, dass es keinen Timeout gibt. Timeout sollte nicht für synchrone XMLHttpRequest-Anfragen verwendet werden, die in einer Dokumentumgebung verwendet werden, da dies eine InvalidAccessError-Ausnahme auslösen würde. Wenn ein Timeout auftritt, wird ein timeout-Ereignis ausgelöst.
Hinweis: Sie dürfen keinen Timeout für synchrone Anfragen mit einem besitzenden Fenster verwenden.
Beispiel
const xhr = new XMLHttpRequest();
xhr.open("GET", "/server", true);
xhr.timeout = 2000; // time in milliseconds
xhr.onload = () => {
// Request finished. Do processing here.
};
xhr.ontimeout = (e) => {
// XMLHttpRequest timed out. Do something here.
};
xhr.send(null);
Spezifikationen
| Spezifikation |
|---|
| XMLHttpRequest # the-timeout-attribute |