Dieser Inhalt wurde automatisch aus dem Englischen übersetzt, und kann Fehler enthalten. Erfahre mehr über dieses Experiment.

View in English Always switch to English

XMLHttpRequest: timeout-Eigenschaft

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since ⁨Juli 2015⁩.

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.

Verwendung eines Timeouts mit einer asynchronen Anfrage.

Beispiel

js
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

Specification
XMLHttpRequest
# the-timeout-attribute

Browser-Kompatibilität