Formations — 1 037 leçons en français

Accueil › Node.js › Premier script et outillage intégré

Premier script et outillage intégré

Démarrer avec Nodedebutant

node serveur.js                    # exécuter
node --watch serveur.js            # relancer à chaque modification
node --test                        # exécuter les tests
node --env-file=.env serveur.js    # charger les variables
node                               # boucle interactive

Ces quatre options sont intégrées. Aucune dépendance à installer.

Le projet minimal

{
  "name": "mon-api",
  "type": "module",
  "scripts": {
    "dev": "node --watch --env-file=.env src/serveur.js",
    "test": "node --test",
    "start": "node src/serveur.js"
  }
}

"type": "module" active les modules ES : import plutôt que require. C'est le choix par défaut d'un projet neuf.

Le premier serveur

import { createServer } from "node:http";

const serveur = createServer((req, res) => {
  res.writeHead(200, { "Content-Type": "application/json" });
  res.end(JSON.stringify({ message: "Bonjour" }));
});

serveur.listen(3000, () => console.log("http://localhost:3000"));

Le préfixe node: n'est pas décoratif : il dit explicitement qu'il s'agit d'un module interne, et empêche qu'un paquet installé du même nom prenne sa place.

Le code de sortie

try {
  await migrer();
} catch (e) {
  console.error(e);
  process.exitCode = 1;        // ⚠️ sans ça, le script « réussit »
}

C'est le seul signal que lit l'intégration continue.

Les termes à connaître

Mode veille

node --watch relance le programme quand un fichier change. Intégré depuis Node 18, il remplace l'outil qu'on installait pour ça.

Exécuteur de tests intégré

node --test découvre et exécute les fichiers de test, sans aucune dépendance. Stable depuis Node 20.

Fichier d'environnement

node --env-file=.env charge les variables sans bibliothèque. Les valeurs déjà présentes dans l'environnement ne sont pas écrasées.

REPL

La boucle interactive lancée par node sans argument. Utile pour vérifier un comportement en dix secondes.

Point d'entrée

Le fichier passé à node. C'est lui qui définit le répertoire de travail apparent des chemins relatifs du module.

Code de sortie

Zéro si tout va bien, autre chose sinon. C'est le seul signal que lit l'intégration continue.

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.