XMLHttpRequest.timeout

La propriété XMLHttpRequest.timeout est un unsigned long (un entier long, non-signé) représentant la durée, en millisecondes, qu'une requête peut prendre avant d'être automatiquement terminée. Par défaut, la valeur est 0 et il n'y pas de timeout. Lorsqu'une requête expire, un évènement timeout est déclenché.

Note : Ces délais d'expiration ne devraient pas être utilisés pour les requêtes XMLHttpRequest synchrones dans un environnement de document : ils déclencheront une exception InvalidAccessError. On ne peut donc pas utiliser de timeout pour les requêtes synchrones avec une fenêtre parente.

Exemples

var xhr = new XMLHttpRequest();
xhr.open('GET', '/server', true);

xhr.timeout = 2000; // durée en millisecondes

xhr.onload = function () {
  // Requête terminée. On traite le résultat ici.
};

xhr.ontimeout = function (e) {
  // Requête qui a expiré. On traite ce cas.
};

xhr.send(null);

Spécifications

Spécification État Commentaires
XMLHttpRequest Standard évolutif Standard évolutif WHATWG

Compatibilité des navigateurs

Update compatibility data on GitHub
OrdinateurMobile
ChromeEdgeFirefoxInternet ExplorerOperaSafariWebview AndroidChrome pour AndroidFirefox pour AndroidOpera pour AndroidSafari sur iOSSamsung Internet
timeoutChrome Support complet 29Edge Support complet 12Firefox Support complet 12IE Support complet 8Opera Support complet 17
Support complet 17
Aucun support 12 — 16
Safari Support complet 6.1WebView Android Support complet ≤37Chrome Android Support complet 29Firefox Android Support complet 14Opera Android Support complet 18
Support complet 18
Aucun support 12 — 16
Safari iOS Support complet 7Samsung Internet Android Support complet 2.0

Légende

Support complet  
Support complet

Pour Internet Explorer, la propriété timeout ne peut être définie qu'après avoir appelé la méthode open() et avant d'appeler la méthode send().