Formations — 1 037 leçons en français

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. get rend la première occurrence, getAll toutes — 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.

Lire l'explication détaillée et faire le quiz →

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.