Formations — 1 037 leçons en français

Accueil › Node.js › Le corps de la requête, et sa validation

Le corps de la requête, et sa validation

Express — les basesdebutant

app.use(express.json({ limit: "100kb" }));

app.post("/produits", (req, res) => {
  console.log(req.body.nom);
});

express.json() lit le flux de la requête, le concatène et appelle JSON.parse. Il remplit req.body. Il s'arrête là.

Analyser n'est pas valider

// Corps reçu, parfaitement analysable :
{ "prix": -500, "nom": "", "admin": true }

Rien dans cette requête ne fait échouer express.json(). Le JSON est syntaxiquement correct, donc l'analyse réussit, donc req.body contient un prix négatif, un nom vide et un champ admin que personne n'avait prévu. Si la route écrit ce corps en base, l'enregistrement aberrant y restera.

C'est la confusion la plus coûteuse du chapitre : un corps analysé n'est pas un corps valide. Express ne connaît ni vos champs, ni vos types, ni vos bornes. La validation est un travail à part, placé entre l'analyse et le traitement.

app.post("/produits", (req, res) => {
  const fautes = valider(req.body);

  if (fautes.length > 0) {
    return res.status(400).json({ erreur: "corps invalide", fautes });
  }

  // ici seulement, req.body est utilisable
});

Trois points à savoir dès maintenant

Les termes à connaître

`express.json()`

L'intergiciel qui lit le flux de la requête, le concatène et appelle JSON.parse. Il remplit req.body. Il n'applique aucune règle métier : un corps analysé n'est pas un corps valide.

Analyser

Transformer des octets en structure de données. L'opération réussit dès que la syntaxe JSON est correcte — {} et {"prix": -9000} sont tous deux parfaitement analysables.

Valider

Vérifier que la structure obtenue respecte les règles de l'application : champs requis présents, types attendus, valeurs dans les bornes, champs inconnus refusés. C'est votre travail, pas celui d'Express.

`limit`

L'option de taille maximale de express.json(), 100 Ko par défaut. Un corps plus grand provoque une erreur dont le type vaut entity.too.large, à traduire en code 413.

Champ inconnu

Un champ du corps qu'aucune règle ne décrit. Le refuser protège contre l'écriture de propriétés non prévues dans la base ; l'ignorer en silence laisse croire au client que sa valeur a été prise en compte.

Rapport de validation

La liste complète des fautes, pas la première. Un client qui reçoit une faute à la fois doit faire autant d'allers-retours que de champs erronés, et un formulaire ne peut pas afficher ses messages d'un coup.

Erreur 422

Le code employé quand le corps est syntaxiquement correct mais sémantiquement refusé. 400 convient aussi et reste le plus répandu ; ce qui compte est de ne pas renvoyer 500 pour une faute du client.

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.