Node.js — Les fondamentaux

Guide 02 / 4

Les essentiels de Node.js

Syntaxe, commandes et choix techniques expliqués, avec des exemples courts à adapter.

Résultat attendu :

Choisir une instruction ou une commande et prévoir son effet.

Lecture
0%

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.

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.

npm start
npm run dev
npm test
À retenir :

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.

PORT=3001 npm start
À retenir :

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.

npm install --save-dev sass@1
npm ci
À retenir :

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.

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.

const url = new URL(requete.url, "http://localhost");
const q = url.searchParams.get("q") ?? "";
const duree = url.searchParams.get("duree") ?? "0";
À retenir :

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.

const valide = /^\d{1,4}$/.test(dureeSaisie) && Number(dureeSaisie) <= 1440;
À retenir :

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.

for await (const morceau of requete) {
  // Compter les octets et conserver les morceaux dans la limite choisie.
}
À retenir :

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.

const nouvelle = {
  id: prochainId++,
  titre: valeur.titre.trim(),
  duree_minutes: valeur.duree_minutes
};
À retenir :

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.

const contenu = await readFile(new URL("../public/index.html", import.meta.url));
À retenir :

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.

curl -i 'http://127.0.0.1:3000/api/recettes?duree=20'
curl -i http://127.0.0.1:3000/api/recettes/9999
À retenir :

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.

curl -i -X POST http://127.0.0.1:3000/api/recettes -H "Content-Type: application/json" --data-binary @compote.json
À retenir :

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.

npm test
À retenir :

Le fichier api.test.js teste recherche, création, rejet et accès aux fichiers. Aucun serveur manuel ne doit être lancé pour lui.