Accueil › Node.js › Lire la requête
Lire la requête
Un serveur HTTP sans frameworkdebutant
L'objet req porte deux choses de natures très différentes : des métadonnées
disponibles tout de suite, et un corps qui arrive dans le temps.
createServer((req, res) => {
console.log(req.method); // "POST"
console.log(req.url); // "/articles?page=2"
console.log(req.headers["content-type"]); // "application/json"
});
Le corps est un flux
const morceaux = [];
req.on("data", (m) => morceaux.push(m));
req.on("end", () => {
const corps = Buffer.concat(morceaux).toString("utf8");
res.end(corps.length + " octets reçus");
});
Le corps n'arrive pas d'un coup. Lire le premier morceau et répondre fonctionne en test local, avec vingt octets, puis échoue dès qu'un client envoie un vrai document.
Accumuler sans limite est une faille
let taille = 0;
const LIMITE = 1e6;
req.on("data", (m) => {
taille += m.length;
if (taille > LIMITE) {
res.writeHead(413).end();
req.destroy(); // ⚠️ indispensable
return;
}
morceaux.push(m);
});
Sans plafond, un seul client peut remplir la mémoire du processus jusqu'à ce qu'il soit tué — et toutes les requêtes en cours tombent avec lui. C'est un déni de service à une ligne de code.
Analyser la cible
const url = new URL(req.url, `http://${req.headers.host}`);
url.pathname; // "/articles"
url.searchParams.get("page"); // "2"
req.url ne contient ni protocole ni hôte, d'où la base. Et req.query
n'existe pas : c'est un ajout d'Express.
Les termes à connaître
- `IncomingMessage`
L'objet
req. Il porte la méthode, la cible, les en-têtes, et c'est aussi un flux lisible qui transporte le corps.- `req.url`
Le chemin et la chaîne de requête, jamais le nom d'hôte ni le protocole. Mal nommé : ce n'est pas une URL complète.
- Corps en flux
Le corps arrive par morceaux, dans le temps. Rien ne garantit qu'il tienne dans un seul événement
data.- `new URL`
L'analyseur d'URL intégré. Il sépare chemin et paramètres, décode les séquences pour cent, et refuse ce qui est invalide.
- `searchParams`
Les paramètres de la chaîne de requête.
getrend la première occurrence,getAlltoutes — un paramètre peut être répété.- Limite de taille
Le plafond au-delà duquel on refuse le corps. Accumuler sans limite est une faille de déni de service, pas une maladresse.
- `413`
Le code de statut pour un corps trop volumineux : « Content Too Large ». La réponse juste quand la limite est franchie.
Cette page présente la partie essentielle de la leçon. Les exemples commentés, les pièges courants et les trois questions de quiz sont dans l'application.