XMLHttpRequest : propriété timeout
Baseline
Large disponibilité
Cette fonctionnalité est bien établie et fonctionne sur de nombreux appareils et versions de navigateurs. Elle est disponible sur tous les navigateurs depuis juillet 2015.
Note : Cette fonctionnalité est disponible via les Web Workers, sauf pour les Service Workers.
La propriété timeout de l'interface XMLHttpRequest est un unsigned long représentant le nombre de millisecondes qu'une requête peut prendre avant d'être automatiquement terminée. La valeur par défaut est 0, ce qui signifie qu'il n'y a pas de délai d'attente. Le délai d'attente ne doit pas être utilisé pour les requêtes XMLHttpRequest synchrones utilisées dans un environnement de document ou il lève une exception InvalidAccessError. Lorsqu'un délai d'attente se produit, un évènement de dépassement du délai est déclenché.
Note : Il n'est pas possible d'utiliser un délai d'attente pour les requêtes synchrones avec une fenêtre propriétaire.
Exemples
const xhr = new XMLHttpRequest();
xhr.open("GET", "/server", true);
xhr.timeout = 2000; // durée en millisecondes
xhr.onload = () => {
// Requête terminée. Traiter le résultat ici.
};
xhr.ontimeout = (e) => {
// Requête qui a expiré. Traiter ce cas.
};
xhr.send(null);
Spécifications
| Spécification |
|---|
| XMLHttpRequest # the-timeout-attribute |