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 July 2015.

Hinweis: Diese Funktion ist in Web Workers verfügbar, mit Ausnahme von Service Workers.

Die XMLHttpRequest.timeout-Eigenschaft ist ein unsigned long, das die Anzahl der Millisekunden darstellt, die ein Request dauern kann, bevor er automatisch beendet wird. Der Standardwert ist 0, was bedeutet, dass es kein Timeout gibt. Timeout sollte nicht für synchrone XMLHttpRequests verwendet werden, die in einer document environment verwendet werden, da sonst eine InvalidAccessError-Ausnahme ausgelöst wird. Wenn ein Timeout eintritt, wird ein timeout-Ereignis ausgelöst.

Hinweis: Sie dürfen für synchronisierte Requests mit einem zugehörigen Fenster kein Timeout verwenden.

Verwendung eines Timeouts bei einem asynchronen Request.

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 Standard
# the-timeout-attribute

Browser-Kompatibilität

BCD tables only load in the browser