Guide 02 / 4
Les essentiels de Node.js
Syntaxe, commandes et choix techniques expliqués, avec des exemples courts à adapter.
Choisir une instruction ou une commande et prévoir son effet.
01 · Préparer et lancer le projet
Exécuter les commandes depuis mini-blog-node/.
Vérifier l’environnement
Contrôler la version et l’accès aux exécutables. Cet atelier cible Node 24.x pour garder un environnement précis.
Exemple
node --version
npm --version
Définir les scripts npm
Les scripts regroupent les commandes du projet. start lance le serveur, dev le relance lors des modifications, test exécute les tests natifs.
Exemple
npm start
npm run dev
npm test
Créer le package.json complet de l’atelier avant de lancer ces commandes.
Arrêt et configuration locale
Ctrl+C arrête le serveur. PORT est une variable d’environnement optionnelle ; sa valeur est une chaîne avant conversion et validation.
Exemple
PORT=3001 npm start
La syntaxe ci-dessus est celle de Bash. Sur un autre shell, définir PORT avec sa syntaxe propre.
Dépendances et scripts npm, en prolongement
Une dépendance de développement sert à construire ou vérifier le projet. Une installation normale met à jour le verrou ; npm ci utilise un verrou existant sans le recalculer.
Exemple
npm install --save-dev sass@1
npm ci
Le premier exemple prépare le cours SCSS. npm ci exige un package-lock.json cohérent.
02 · Lire et écrire les traitements HTTP
Les extraits supposent les imports et variables correspondants ; les fichiers complets sont dans l’atelier.
createServer et listen
createServer reçoit une fonction appelée pour chaque requête. listen ouvre l’écoute. L’atelier sépare la création du serveur de son lancement afin de pouvoir le tester.
Exemple
import { createServer } from "node:http";
const serveur = createServer((req, res) => {
res.writeHead(200, { "Content-Type": "text/plain; charset=utf-8" });
res.end("À table !");
});
serveur.listen(3000, "127.0.0.1");
URL et paramètres de recherche
URL décompose le chemin et les paramètres. searchParams évite de découper l’adresse à la main.
Exemple
const url = new URL(requete.url, "http://localhost");
const q = url.searchParams.get("q") ?? "";
const duree = url.searchParams.get("duree") ?? "0";
La base fixe sert seulement à analyser une URL relative. Les paramètres doivent encore être validés.
Valider les filtres
L’atelier accepte une durée entière de 0 à 1440 ; 0 signifie toutes les durées. On vérifie le texte avant conversion pour refuser abc, -1 et 2.5.
Exemple
const valide = /^\d{1,4}$/.test(dureeSaisie) && Number(dureeSaisie) <= 1440;
La recherche normalise casse et espaces de bord, mais ne retire pas les accents.
Lire un corps JSON
Une requête HTTP est un flux de morceaux. Le serveur les lit de façon asynchrone, limite ce qu’il garde en mémoire, puis interprète le JSON.
Exemple
for await (const morceau of requete) {
// Compter les octets et conserver les morceaux dans la limite choisie.
}
Le fichier complet limite le corps à 16 Kio. Cette limite mémoire et un délai ne remplacent pas une politique complète contre un grand nombre de requêtes.
Copier les champs autorisés
Après validation, construire un nouvel objet avec les seuls champs du contrat. Ne pas accepter l’id envoyé par le client et ne pas recopier toutes ses propriétés.
Exemple
const nouvelle = {
id: prochainId++,
titre: valeur.titre.trim(),
duree_minutes: valeur.duree_minutes
};
Le fichier complet vérifie aussi portions, catégorie et les tableaux de lignes.
Servir les fichiers publics
readFile lit les fichiers en asynchrone. Une liste fixe associe les URL autorisées aux fichiers publics ; les fichiers src/ et package.json ne sont pas servis.
Exemple
const contenu = await readFile(new URL("../public/index.html", import.meta.url));
Ne pas concaténer directement un chemin demandé par l’utilisateur au chemin du disque.
03 · Interroger et tester
Commencer par une réponse simple, puis tester les cas limites.
curl pour une lecture
curl affiche le contenu reçu. -i ajoute les en-têtes et permet de vérifier le statut.
Exemple
curl -i 'http://127.0.0.1:3000/api/recettes?duree=20'
curl -i http://127.0.0.1:3000/api/recettes/9999
Attendu : 200 et deux recettes, puis 404.
curl pour une création
Envoyer un fichier JSON rend le corps lisible et évite les erreurs d’échappement du shell. Créer compote.json depuis l’exemple complet.
Exemple
curl -i -X POST http://127.0.0.1:3000/api/recettes -H "Content-Type: application/json" --data-binary @compote.json
Attendu : 201 et un en-tête Location. Les ajouts disparaissent au redémarrage du processus.
node:test et assert
Le test lance un serveur isolé sur un port disponible, envoie de vraies requêtes et ferme le serveur à la fin. Les assertions vérifient des comportements utiles au client.
Exemple
npm test
Le fichier api.test.js teste recherche, création, rejet et accès aux fichiers. Aucun serveur manuel ne doit être lancé pour lui.