Accueil › Node.js › Le premier serveur
Le premier serveur
Un serveur HTTP sans frameworkdebutant
Un serveur HTTP en Node tient en cinq lignes, sans aucune dépendance.
import { createServer } from "node:http";
const serveur = createServer((req, res) => {
res.writeHead(200, { "content-type": "text/plain; charset=utf-8" });
res.end("Bonjour\n");
});
serveur.listen(3000, () => console.log("En écoute sur http://localhost:3000"));
createServer enregistre une fonction, appelée à chaque requête. Elle
reçoit deux objets : req, ce que le client a envoyé, et res, ce que vous
allez écrire.
Le contrat
Votre gestionnaire doit terminer la réponse. Node ne le fera pas pour vous.
createServer((req, res) => {
console.log(req.method, req.url); // ⛔ aucune réponse
});
Ce code journalise la requête et laisse le client attendre jusqu'à son propre délai d'expiration. Il n'y a ni 200 automatique, ni 500 automatique : une connexion ouverte sans réponse reste ouverte.
Ce que le natif ne fait pas
Pas de routage, pas d'analyse du corps, pas de res.json, pas de gestion
d'erreur. Tout cela est exactement ce qu'un framework ajoute — et c'est la
raison d'écrire un serveur à la main une fois : savoir ce qu'Express fait à
votre place.
Les termes à connaître
- `node:http`
Le module interne qui parle HTTP. Express, Fastify et les autres frameworks s'appuient dessus — ils ne le remplacent pas.
- `createServer`
Crée un serveur et enregistre une fonction appelée à chaque requête, avec deux arguments : la requête et la réponse.
- Gestionnaire de requête
La fonction
(req, res) => …. Son contrat est simple et impitoyable : elle doit terminer la réponse, sinon le client attend.- `listen`
Attache le serveur à un port et commence à accepter des connexions. C'est un appel asynchrone : le serveur n'écoute pas encore à la ligne suivante.
- `EADDRINUSE`
Le port est déjà pris par un autre processus. L'erreur la plus fréquente au démarrage, et elle n'a presque jamais la cause qu'on croit.
- Arrêt propre
server.close()refuse les nouvelles connexions et laisse finir celles en cours. Sans lui, un redéploiement coupe des requêtes en vol.
Cette page présente la partie essentielle de la leçon. Les exemples commentés, les pièges courants et les trois questions de quiz sont dans l'application.