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.
Reproduire le projet, vérifier ses comportements et réussir une modification autonome.
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.
Exemple
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
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.
Exemple
npm start
http://127.0.0.1:3000/
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.
Exemple
q=soupe → 1 recette
duree=20 → soupe et salade, 2 recettes
q=tarte&duree=20 → 0 recette
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.
Exemple
POST /api/recettes → 201
GET /api/recettes/{id reçu} → 200
GET /api/recettes → total 4
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.
Exemple
npm test
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.
Exemple
<option value="15">15 minutes</option>
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.
Exemple
Attendu : 422, aucune recette ajoutée.
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.
Exemple
Format text/plain → 415
Corps "{" avec application/json → 400
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.
Exemple
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);