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
(en-US) est déclenché.
Note : Pour un exemple, voir Utiliser la propriété timeout
avec une requête asynchrone (en-US).
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
js
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
Specification |
---|
XMLHttpRequest Standard # the-timeout-attribute |
Compatibilité des navigateurs
BCD tables only load in the browser