XMLHttpRequestEventTarget: timeout Ereignis
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.
Das timeout Ereignis wird ausgelöst, wenn der Fortschritt aufgrund einer abgelaufenen voreingestellten Zeit beendet wird.
Syntax
Verwenden Sie den Ereignisnamen in Methoden wie addEventListener(), oder setzen Sie eine Ereignishandlereigenschaft.
addEventListener("timeout", (event) => { })
ontimeout = (event) => { }
Ereignistyp
Ein ProgressEvent. Erbt von Event.
Beispiele
Verwendung mit XMLHttpRequest
const client = new XMLHttpRequest();
client.open("GET", "http://www.example.org/example.txt");
client.ontimeout = () => {
console.error("Timeout!!");
};
client.send();
Sie können den Ereignishandler auch mit der Methode addEventListener() einrichten:
client.addEventListener("timeout", () => {
console.error("Timeout!!");
});
Verwendung mit XMLHttpRequestUpload
Sie können das timeout Ereignis verwenden, um einen Upload zu erkennen, der gestoppt wurde, weil er zu langsam war. Ein vollständiges Codebeispiel, das eine Datei hochlädt und eine Fortschrittsanzeige anzeigt, finden Sie auf der Hauptseite von XMLHttpRequestUpload.
Das Timeout wird auf dem XMLHttpRequest Objekt mit der XMLHttpRequest.timeout Eigenschaft gesetzt.
// In case of a 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
| Spezifikation |
|---|
| XMLHttpRequest # event-xhr-timeout |
| XMLHttpRequest # handler-xhr-ontimeout |