Guide 01 / 4
Lexique Node.js
Comprendre les concepts de Node.js et leur place dans le mini-blog.
Expliquer chaque notion en la reliant à une opération du projet.
01 · Se repérer dans le parcours confirmé
On reprend le mini-blog « À table ! » avec davantage de structure et des frontières explicites entre serveur, outils de compilation et navigateur.
Le fil rouge et les acquis visés
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. Les données de référence restent Soupe de carottes (20 min), Salade de tomates (10 min) et Tarte aux pommes (45 min).
Exemple
01. Node.js : exposer et tester une API HTTP de recettes, puis la consommer depuis le navigateur.
02. SCSS : organiser la présentation du mini-blog en modules et compiler une feuille CSS.
03. TypeScript : modéliser les recettes et vérifier les réponses de l’API avant de les afficher.
Chaque cours comprend quatre guides : lexique, essentiels, atelier et ressources. Les fichiers complets sont à la fin de l’atelier.
Prérequis et environnement
Maîtriser les bases de JavaScript : fonctions, objets, tableaux, conditions, DOM et événements. Utiliser Node.js 24.x et npm, un éditeur et un terminal. Le serveur de cet atelier n’a aucune dépendance npm externe ; aucun framework n’est nécessaire pour comprendre les mécanismes HTTP.
Exemple
mini-blog-node/
├── package.json
├── src/
│ ├── index.js
│ ├── server.js
│ └── recettes.js
├── public/
│ ├── index.html
│ ├── app.js
│ └── style.css
└── test/
└── api.test.js
Travailler dans un projet mini-blog-node/ séparé des fichiers de cours Technipédia. Garder une copie de chaque étape fonctionnelle. Les chemins des exemples partent de la racine de ce projet.
La méthode et les limites de l’atelier
Lire le vocabulaire, reproduire un petit exemple, construire l’atelier puis vérifier ses résultats. Les fiches courtes illustrent une notion ; seuls les fichiers annoncés comme complets constituent l’application à reproduire.
Exemple
Comprendre → reproduire → modifier → observer → expliquer
La branche Node.js est une nouvelle implémentation pédagogique : elle ne réutilise pas le serveur PHP/PDO du parcours débutant. Son stockage initial est en mémoire ; SCSS et TypeScript prolongent ce même projet Node.
02 · Comprendre l’environnement Node.js
Le langage reste JavaScript ; les API et le lieu d’exécution changent.
Runtime et moteur JavaScript
Un runtime fournit un environnement pour exécuter un langage. Node.js permet d’exécuter JavaScript hors du navigateur avec des API réseau, fichiers et processus.
Exemple
node --version
node src/index.js
document et window n’existent pas côté serveur. Le fichier public/app.js, lui, s’exécute dans le navigateur.
Processus et port
Le programme Node est un processus qui peut écouter un port TCP. Le navigateur contacte une adresse composée d’un protocole, d’un hôte et d’un port.
Exemple
http://127.0.0.1:3000
# HTTP, machine locale, port 3000
Deux serveurs ne peuvent généralement pas écouter simultanément la même adresse et le même port.
Module ES et import/export
Un module expose des fonctions avec export et charge celles d’un autre fichier avec import. type: module dans package.json choisit ce mode pour les .js du projet.
Exemple
export function doubler(n) { return n * 2; }
// Dans un autre fichier :
import { doubler } from "./calcul.js";
Inclure l’extension .js dans les imports relatifs de cet atelier.
Module natif et paquet npm
Un module natif est livré avec Node.js, par exemple node:http. Un paquet npm est installé séparément. npm sert aussi à exécuter les scripts du projet.
Exemple
import { createServer } from "node:http";
// Aucun npm install nécessaire pour node:http.
package.json et verrou de dépendances
package.json décrit le projet, ses scripts et ses dépendances. package-lock.json fixe les versions résolues après une installation npm pour faciliter la reproduction.
Exemple
npm run dev
npm test
L’atelier Node sans dépendance se lance sans installation. SCSS puis TypeScript ajouteront des outils de développement et un fichier de verrou.
Event loop et traitement non bloquant
Node coordonne les callbacks et les opérations asynchrones. Attendre une lecture de fichier asynchrone laisse le processus traiter d’autres événements ; un long calcul JavaScript bloque toujours ce travail.
Exemple
const contenu = await readFile(urlDuFichier);
async ne rend pas un calcul lourd automatiquement parallèle. Éviter les lectures synchrones dans le traitement des requêtes.
03 · Décrire une API HTTP
Le navigateur et le serveur se mettent d’accord sur des adresses et des données.
Route, méthode et ressource
Une route associe une méthode HTTP et un chemin à un traitement. La collection est /api/recettes ; une recette précise est /api/recettes/1.
Exemple
GET /api/recettes
GET /api/recettes/1
POST /api/recettes
Requête, réponse et en-tête
La requête porte méthode, adresse, en-têtes et éventuellement un corps. La réponse fournit un statut, des en-têtes et un contenu.
Exemple
Content-Type: application/json; charset=utf-8
Location: /api/recettes/4
Content-Type décrit le format envoyé ; Location indique ici l’adresse de la ressource créée.
JSON et contrat de données
JSON transporte objets, tableaux et valeurs simples. Le contrat du blog choisit des nombres pour durée et portions, et des tableaux de chaînes pour ingrédients et étapes.
Exemple
{"donnees":[{"id":1,"titre":"Soupe de carottes","duree_minutes":20,"portions":2,"categorie":"Plat","ingredients":["4 carottes"],"etapes":["Cuire."]}],"total":1}
Dans les cours PHP/MySQL, ingrédients et étapes étaient du texte multiligne. Une future connexion SQL à cette API devra explicitement convertir ce texte en tableaux.
Statuts HTTP utiles
200 indique une lecture réussie, 201 une création. 400 signale une requête mal formée, 404 une absence, 405 une méthode refusée, 413 un corps trop volumineux, 415 un format refusé et 422 des champs incohérents.
Exemple
JSON mal formé → 400
Durée négative dans un JSON valide → 422
Recette ajoutée → 201
Promesse, async et await
Une promesse représente un résultat à venir ou un échec. async permet d’utiliser await pour attendre ce résultat dans la fonction ; try/catch traite les échecs.
Exemple
async function lireRecettes() {
const reponse = await fetch("http://127.0.0.1:3000/api/recettes");
if (!reponse.ok) throw new Error(`HTTP ${reponse.status}`);
return reponse.json();
}
fetch ne rejette pas automatiquement les réponses 404 ou 500 : vérifier reponse.ok.
Origine et CORS
L’origine comprend protocole, hôte et port. Le serveur de l’atelier sert la page et l’API sur la même origine : aucun réglage CORS n’est nécessaire.
Exemple
Page : http://127.0.0.1:3000/
API : http://127.0.0.1:3000/api/recettes
Ouvrir la page depuis un autre port ou file:// change cette situation ; utiliser l’URL servie par Node.