MDN self-hosted library · e01.org

XMLHttpRequest: timeout property

XMLHttpRequest API windowandworkerexceptservice

Open notebook · 1 cells web-api-instance-property upstream source

XMLHttpRequest API window_and_worker_except_service

The XMLHttpRequest.timeout property is an unsigned long representing the number of milliseconds a request can take before automatically being terminated. The default value is 0, which means there is no timeout. Timeout shouldn't be used for synchronous XMLHttpRequests requests used in a document environment or it will throw an InvalidAccessError exception. When a timeout happens, a timeout event is fired.

[!NOTE] You may not use a timeout for synchronous requests with an owning window.

Using a timeout with an asynchronous request.

Example

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);

Specifications

Browser compatibility