Node.js — Les fondamentaux

Guide 01 / 4

Lexique Node.js

Comprendre les concepts de Node.js et leur place dans le mini-blog.

Résultat attendu :

Expliquer chaque notion en la reliant à une opération du projet.

Lecture
0%

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).

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.
À retenir :

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.

mini-blog-node/
├── package.json
├── src/
│   ├── index.js
│   ├── server.js
│   └── recettes.js
├── public/
│   ├── index.html
│   ├── app.js
│   └── style.css
└── test/
    └── api.test.js
À retenir :

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.

Comprendre → reproduire → modifier → observer → expliquer
À retenir :

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.

node --version
node src/index.js
À retenir :

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.

http://127.0.0.1:3000
# HTTP, machine locale, port 3000
À retenir :

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.

export function doubler(n) { return n * 2; }
// Dans un autre fichier :
import { doubler } from "./calcul.js";
À retenir :

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.

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.

npm run dev
npm test
À retenir :

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.

const contenu = await readFile(urlDuFichier);
À retenir :

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.

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.

Content-Type: application/json; charset=utf-8
Location: /api/recettes/4
À retenir :

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.

{"donnees":[{"id":1,"titre":"Soupe de carottes","duree_minutes":20,"portions":2,"categorie":"Plat","ingredients":["4 carottes"],"etapes":["Cuire."]}],"total":1}
À retenir :

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.

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.

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();
}
À retenir :

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.

Page : http://127.0.0.1:3000/
API : http://127.0.0.1:3000/api/recettes
À retenir :

Ouvrir la page depuis un autre port ou file:// change cette situation ; utiliser l’URL servie par Node.