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

Browser-Kompatibilität

Report problems with this compatibility data on GitHub
desktopmobile
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
timeout

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support
Has more compatibility info.