Node.js — Les fondamentaux

Guide 03 / 4

Atelier Node.js · À table !

Construire une API HTTP locale avec les modules natifs de Node.js : liste filtrable, fiche par identifiant et ajout validé ; afficher ses données dans le navigateur et tester les réponses HTTP.

Résultat attendu :

Reproduire le projet, vérifier ses comportements et réussir une modification autonome.

Lecture
0%

01 · Construire le mini-blog HTTP

Reproduire les fichiers complets ci-dessous dans le projet de travail.

Étape 1 · Créer l’arborescence

Créer package.json, src/, public/ et test/, puis chaque fichier à son chemin. Le jeu initial est une fonction qui produit des recettes neuves à chaque création de serveur.

src/recettes.js : données, filtre et validation
src/server.js : routage et HTTP
src/index.js : lancement
public/ : interface du navigateur
test/api.test.js : vérification du contrat
À retenir :

Le dossier de cours contient du JSON pédagogique ; les fichiers d’application sont à créer dans mini-blog-node/.

Étape 2 · Lancer sans dépendance externe

Exécuter npm start et ouvrir l’adresse indiquée. Le serveur fournit index.html, style.css, app.js et l’API. La page charge les recettes avec fetch.

npm start
http://127.0.0.1:3000/
À retenir :

Attendu : trois cartes complètes avec ingrédients et préparation ; le message de chargement devient un total de trois recettes.

Étape 3 · Faire deux recherches

Saisir soupe puis valider. Vider ensuite la saisie, choisir 20 minutes et valider. Observer les requêtes dans l’onglet Réseau du navigateur.

q=soupe → 1 recette
duree=20 → soupe et salade, 2 recettes
q=tarte&duree=20 → 0 recette
À retenir :

La page recharge les données par HTTP ; elle ne filtre pas seulement des cartes déjà présentes.

Étape 4 · Créer puis retrouver une recette

Créer compote.json avec le fichier complet puis l’envoyer avec curl. Suivre l’adresse Location reçue et recharger la liste.

POST /api/recettes → 201
GET /api/recettes/{id reçu} → 200
GET /api/recettes → total 4
À retenir :

Arrêter puis relancer Node ramène le total à 3. Cette version utilise la mémoire du processus, pas MySQL ni un fichier JSON persistant.

02 · Tester, corriger et étendre

Comparer les statuts autant que le contenu.

Étape 5 · Exécuter les tests du contrat

Lancer npm test. Lire le test de création, puis repérer celui qui empêche une durée négative et celui qui refuse l’accès aux sources.

npm test
À retenir :

Attendu : test réussi. Une erreur fait terminer la commande avec un code non nul.

Exercice · Ajouter une limite de 15 minutes

Ajouter une option 15 minutes dans public/index.html. Vérifier qu’aucun changement serveur n’est nécessaire et que seule la salade apparaît sur le jeu initial.

<option value="15">15 minutes</option>
À retenir :

Corrigé : insérer l’option dans #duree-max. Le contrat accepte déjà toute durée entière entre 0 et 1440.

Exercice · Refuser une catégorie inconnue

Créer une copie de compote.json avec categorie: "Goûter" et envoyer la requête. Expliquer à quel endroit la demande est rejetée.

Attendu : 422, aucune recette ajoutée.
À retenir :

Corrigé : validerRecette vérifie la liste Entrée, Plat, Dessert. Ajouter une catégorie supposerait un choix de contrat et des tests adaptés.

Exercice · Renforcer le test des formats

Ajouter au test une requête POST avec Content-Type: text/plain et une autre contenant un JSON mal formé. Vérifier les statuts attendus.

Format text/plain → 415
Corps "{" avec application/json → 400
À retenir :

Comparer au corrigé suivant après avoir essayé.

Corrigé · Deux échecs HTTP distincts

Insérer ces assertions dans le test avant sa fermeture, avec la fonction appeler déjà définie.

assert.equal((await appeler("/api/recettes", { method: "POST", headers: { "Content-Type": "text/plain" }, body: "test" })).status, 415);
assert.equal((await appeler("/api/recettes", { method: "POST", headers: { "Content-Type": "application/json" }, body: "{" })).status, 400);