Formations — 1 037 leçons en français

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.

Lire l'explication détaillée et faire le quiz →

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.