Comprendre XMLHttpRequest : le moteur d'Ajax expliqué simplement
Responsable des classements d'agences · Anaska
Mis à jour le 14 novembre 2026
XMLHttpRequest (XHR) est l'objet JavaScript qui envoie une requête HTTP au serveur sans recharger la page. C'est lui qui a rendu possible Ajax au milieu des années 2000. On crée l'objet, on ouvre la requête avec open(), on l'envoie avec send(), et on lit la réponse dans l'événement load. Pour un nouveau code, l'API fetch fait la même chose avec une syntaxe plus simple ; XHR reste utile pour suivre la progression d'un envoi de fichier et pour maintenir du code existant.
Ajax, XHR et fetch : qui fait quoi
Ajax n'est pas une technologie mais une façon de faire : charger des données en arrière-plan et mettre à jour une partie de la page, sans la recharger entièrement. Le terme date de 2005 et désignait à l'origine « Asynchronous JavaScript and XML ». Aujourd'hui, les données circulent presque toujours en JSON, mais le nom est resté.
XMLHttpRequest est l'outil historique qui réalise ces échanges. Malgré son nom, il transporte n'importe quel format : JSON, HTML, texte, fichiers. L'API fetch, arrivée en 2015, le remplace dans la plupart des nouveaux projets, et des bibliothèques comme Axios offrent une couche plus confortable au-dessus de l'un ou de l'autre.
Une première requête GET
Voici la forme la plus courante, avec les événements modernes plutôt que l'ancien onreadystatechange :
const xhr = new XMLHttpRequest();
xhr.open("GET", "/api/articles?page=1");
xhr.responseType = "json";
xhr.addEventListener("load", () => {
if (xhr.status >= 200 && xhr.status < 300) {
console.log(xhr.response); // objet JSON déjà décodé
} else {
console.error("Erreur HTTP", xhr.status);
}
});
xhr.addEventListener("error", () => console.error("Erreur réseau"));
xhr.send();
Trois points à retenir. open() ne fait que préparer la requête, rien ne part avant send(). L'événement load se déclenche même pour une erreur 404 ou 500 : il faut tester status. Enfin, responseType = "json" évite d'appeler JSON.parse à la main.
Envoyer des données en POST
Pour envoyer du JSON, on précise l'en-tête Content-Type et on passe une chaîne à send() :
const xhr = new XMLHttpRequest();
xhr.open("POST", "/api/contacts");
xhr.setRequestHeader("Content-Type", "application/json");
xhr.responseType = "json";
xhr.onload = () => console.log(xhr.status, xhr.response);
xhr.send(JSON.stringify({ nom: "Durand", email: "durand@example.com" }));
Pour un formulaire avec fichier, on passe un objet FormData ; le navigateur règle alors seul l'en-tête et l'encodage. setRequestHeader doit toujours être appelé après open() et avant send().
readyState : les cinq états d'une requête
L'ancienne écriture, encore très présente dans le code existant, surveille la propriété readyState :
| Valeur | Nom | Ce que cela veut dire |
|---|---|---|
| 0 | UNSENT | Objet créé, open() pas encore appelé |
| 1 | OPENED | open() appelé |
| 2 | HEADERS_RECEIVED | En-têtes de la réponse reçus |
| 3 | LOADING | Corps de la réponse en cours de réception |
| 4 | DONE | Requête terminée, avec succès ou non |
Dans ce style, on teste xhr.readyState === 4 dans onreadystatechange, puis le code status. Les événements load, error et timeout rendent ce test inutile dans le code récent.
Gérer les erreurs, les délais et l'annulation
Une requête peut échouer de trois façons, et chacune a son événement. error signale un problème réseau ou un blocage CORS. timeout se déclenche si la propriété xhr.timeout (en millisecondes) est dépassée. abort suit un appel à xhr.abort(), utile quand l'utilisateur change de page ou relance une recherche.
Les erreurs HTTP (404, 500) ne passent par aucun de ces événements : elles arrivent dans load, avec le code dans status. Oublier ce test est l'erreur la plus fréquente chez les débutants.
Suivre la progression d'un envoi
C'est le domaine où XHR garde un avantage net sur fetch. L'objet xhr.upload émet des événements progress pendant l'envoi d'un fichier :
xhr.upload.addEventListener("progress", (e) => {
if (e.lengthComputable) {
barre.value = Math.round((e.loaded / e.total) * 100);
}
});
Avec fetch, suivre la progression d'un envoi reste plus compliqué. Pour une barre de progression sur un téléversement, XHR reste donc le choix le plus simple.
CORS : quand le serveur refuse
Par sécurité, le navigateur bloque une requête XHR vers un autre domaine si ce domaine ne l'autorise pas. Le message « blocked by CORS policy » dans la console signifie que le serveur n'a pas renvoyé l'en-tête Access-Control-Allow-Origin attendu. La correction se fait côté serveur, jamais dans le JavaScript.
Pour envoyer des cookies vers un autre domaine, il faut xhr.withCredentials = true côté client et un serveur qui renvoie Access-Control-Allow-Credentials: true avec une origine précise, pas l'étoile.
XMLHttpRequest ou fetch : le comparatif
| Critère | XMLHttpRequest | fetch |
|---|---|---|
| Syntaxe | Événements et rappels | Promesses, async et await |
| Progression de l'envoi | Oui, avec xhr.upload | Difficile |
| Annulation | abort() | AbortController |
| Délai maximal | Propriété timeout | AbortSignal.timeout() |
| Erreurs HTTP | À tester dans status | À tester dans response.ok |
| Requêtes synchrones | Possibles, déconseillées | Impossibles |
La même requête GET avec fetch :
const res = await fetch("/api/articles?page=1");
if (res.ok === false) throw new Error("Erreur HTTP " + res.status);
const articles = await res.json();
Le conseil du développeur
Pour un nouveau projet, écrivez vos appels avec fetch et regroupez-les dans une petite fonction maison qui teste le statut et gère les erreurs une fois pour toutes. Gardez XMLHttpRequest pour les envois de fichiers avec barre de progression.
Si vous maintenez du code ancien plein de onreadystatechange, ne le réécrivez pas d'un coup : il fonctionne. Remplacez-le au fil des modifications, en commençant par les appels qui posent problème. Et n'utilisez jamais le mode synchrone (open(..., false)), qui fige la page et que les navigateurs signalent comme obsolète.
Questions fréquentes
Qu'est-ce que XMLHttpRequest ?
Un objet JavaScript intégré au navigateur qui envoie des requêtes HTTP en arrière-plan, sans recharger la page. C'est la base historique d'Ajax.
XMLHttpRequest est-il obsolète ?
Non, il reste pris en charge par tous les navigateurs. Pour du code neuf, fetch est plus simple, mais XHR reste utile pour suivre la progression d'un envoi de fichier.
Pourquoi mon XHR renvoie-t-il une erreur CORS ?
Le serveur appelé n'autorise pas votre domaine. Il doit renvoyer l'en-tête Access-Control-Allow-Origin. Cela se corrige côté serveur.
XMLHttpRequest ne fonctionne-t-il qu'avec XML ?
Non. Malgré son nom, il transporte du JSON, du texte, du HTML ou des fichiers. On choisit le format avec responseType.
Pour aller plus loin
Une requête Ajax a besoin d'un serveur qui répond proprement. Notre guide pour créer une API REST en PHP montre comment écrire ce côté serveur, avec des réponses JSON et des codes HTTP corrects.
Pour approfondir : créer une API REST en PHP, accélérer une application PHP et erreurs HTML qui pénalisent le référencement.
À lire aussi
- Créer un système de commentaires sans rechargement
- AJAX vs Fetch API en 2026 : quelles différences et laquelle choisir ?
- Gestion des formulaires dynamiques avec AJAX en 2026 : ce que tout développeur devrait savoir
- AJAX et API REST en 2026 : quelle approche choisir pour une application web performante ?
- Comment créer une recherche instantanée avec AJAX en 2026 : faut-il tout coder ou passer par une solution SaaS ?
- Comprendre AJAX et les requêtes asynchrones