XMLHttpRequest : évènement readystatechange
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.
L'évènement readystatechange est déclenché chaque fois que la propriété readyState d'un XMLHttpRequest change.
Attention : Il ne doit pas être utilisé avec des requêtes synchrones et ne doit pas être utilisé à partir de code natif.
Syntaxe
Utilisez le nom de l'évènement dans des méthodes comme addEventListener(), ou définissez une propriété de gestionnaire d'évènement.
js
addEventListener("readystatechange", (event) => { })
onreadystatechange = (event) => { }
Type d'évènement
Un objet Event générique sans propriétés supplémentaires.
Exemples
js
const xhr = new XMLHttpRequest();
const methode = "GET";
const url = "https://developer.mozilla.org/";
xhr.open(methode, url, true);
xhr.onreadystatechange = () => {
// Dans les fichiers locaux, le statut est 0 en cas de succès dans Mozilla Firefox
if (xhr.readyState === XMLHttpRequest.DONE) {
const statut = xhr.status;
if (statut === 0 || (statut >= 200 && statut < 400)) {
// La requête a été complétée avec succès
console.log(xhr.responseText);
} else {
// Oh non ! Il y a eu une erreur avec la requête !
}
}
};
xhr.send();
Spécifications
| Spécification |
|---|
| XMLHttpRequest # event-xhr-readystatechange |
| XMLHttpRequest # handler-xhr-onreadystatechange |