Comprendre XMLHttpRequest : le moteur d'Ajax expliqué simplement

Sebastian

Responsable des classements d'agences · Anaska

Résumer avec l'IA ChatGPT Perplexity Claude Google IA

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 :

ValeurNomCe que cela veut dire
0UNSENTObjet créé, open() pas encore appelé
1OPENEDopen() appelé
2HEADERS_RECEIVEDEn-têtes de la réponse reçus
3LOADINGCorps de la réponse en cours de réception
4DONERequê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èreXMLHttpRequestfetch
SyntaxeÉvénements et rappelsPromesses, async et await
Progression de l'envoiOui, avec xhr.uploadDifficile
Annulationabort()AbortController
Délai maximalPropriété timeoutAbortSignal.timeout()
Erreurs HTTPÀ tester dans statusÀ tester dans response.ok
Requêtes synchronesPossibles, déconseilléesImpossibles

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

Comparer d'abord, signer ensuite.

Données publiques datées, notes toujours sourcées

Échap

Tapez au moins deux lettres : classements, fiches d'agences, logiciels et articles publiés.