Installation et configuration d'Express.js

Preparer le terrain pour Express.js

Avant de pouvoir plonger dans le monde d'Express.js et commencer à construire des applications web, nous devons nous assurer que notre environnement de développement est prêt et initialiser un nouveau projet Node.js. Express.js est un package Node.js, ce qui signifie qu'il s'installe et se gère via le gestionnaire de paquets Node (npm) ou un gestionnaire alternatif comme Yarn.

La première étape indispensable est donc d'avoir Node.js installé sur votre système. L'installation de Node.js inclut automatiquement npm. Vous pouvez vérifier votre installation en ouvrant votre terminal et en tapant les commandes node -v et npm -v, qui devraient afficher les versions respectives installées.

Une fois Node.js et npm (ou Yarn) prêts, la prochaine étape consiste à créer un répertoire dédié pour votre nouveau projet et à l'initialiser. Ouvrez votre terminal, naviguez jusqu'à l'endroit où vous souhaitez créer votre projet, puis créez un nouveau dossier et entrez dedans :

mkdir mon-app-express
cd mon-app-express

Ensuite, initialisez votre projet Node.js. La commande la plus courante est npm init. Elle vous posera une série de questions sur votre projet (nom, version, description, point d'entrée, etc.). Vous pouvez appuyer sur Entrée pour accepter les valeurs par défaut ou les personnaliser. L'option -y permet de sauter toutes les questions et d'accepter directement les valeurs par défaut.

npm init -y

Cette commande crée un fichier essentiel à la racine de votre projet : `package.json`. Ce fichier contient les métadonnées de votre projet et, surtout, il listera toutes les dépendances (comme Express) que nous allons installer. C'est le manifeste de votre application Node.js.

Installer Express.js comme dependance

Maintenant que notre projet est initialisé et que nous avons un fichier `package.json`, nous pouvons installer Express.js. Toujours dans le terminal, à la racine de votre projet (`mon-app-express`), exécutez la commande suivante avec npm :

npm install express

Si vous préférez utiliser Yarn, la commande équivalente est :

yarn add express

Que fait cette commande ?

• Elle télécharge le package Express.js et ses propres dépendances depuis le registre npm (ou Yarn).
• Elle place les fichiers téléchargés dans un répertoire nommé `node_modules` à la racine de votre projet. Ce répertoire contient tous les packages externes dont votre application dépend. (Il est généralement recommandé d'ajouter `node_modules` à votre fichier `.gitignore` pour ne pas le versionner).
• Elle met automatiquement à jour votre fichier `package.json` en ajoutant `express` à la section `dependencies`, avec la version installée. Cela signifie qu'Express est maintenant une dépendance requise pour que votre application fonctionne.

Après l'installation, votre fichier `package.json` devrait ressembler à quelque chose comme ceci (la version d'Express peut varier) :

{
  "name": "mon-app-express",
  "version": "1.0.0",
  "description": "",
  "main": "index.js",
  "scripts": {
    "test": "echo \"Error: no test specified\" && exit 1"
  },
  "keywords": [],
  "author": "",
  "license": "ISC",
  "dependencies": {
    "express": "^4.18.2" 
  }
}

La présence d'Express dans les dépendances garantit que si quelqu'un d'autre récupère votre projet (sans le dossier `node_modules`) et exécute `npm install` (ou `yarn install`), Express sera automatiquement téléchargé et installé dans la version compatible spécifiée.

Configuration minimale : votre premiere application Express

Avec Express.js installé, nous pouvons maintenant créer notre première application web minimaliste. Créez un fichier à la racine de votre projet. Le nom par défaut souvent utilisé comme point d'entrée dans `package.json` est `index.js`, mais vous pouvez aussi l'appeler `app.js` ou `server.js`. Créons un fichier `app.js`.

Dans ce fichier `app.js`, nous allons effectuer les étapes de configuration de base :

1. Importer Express : Comme tout module Node.js, nous devons d'abord l'importer dans notre fichier en utilisant `require()`.
2. Créer une instance de l'application Express : Nous appelons la fonction `express()` importée pour créer l'objet principal de notre application. C'est cet objet (`app`) qui nous permettra de définir les routes, les middlewares, etc.
3. Définir une route simple : Pour tester, nous allons définir une route qui répondra aux requêtes GET sur l'URL racine (`/`).
4. Mettre l'application en écoute : Comme pour le serveur `http` de base, nous devons dire à notre application Express sur quel port écouter les requêtes entrantes.

Voici le code correspondant à ces étapes :

// 1. Importer Express
const express = require('express');

// 2. Créer une instance de l'application Express
const app = express();

// Définir le port d'écoute
const port = 3000;

// 3. Définir une route pour la page d'accueil (URL racine '/')
// app.get(path, callback)
// Le callback reçoit les objets request (req) et response (res), similaires à ceux du module http
app.get('/', (req, res) => {
  // Express simplifie l'envoi de la réponse
  res.send('Bonjour depuis Express !');
});

// 4. Mettre l'application en écoute sur le port spécifié
app.listen(port, () => {
  console.log(`Application Express démarrée sur http://localhost:${port}`);
});

Notez comme Express simplifie la définition de la route avec `app.get()` et l'envoi de la réponse avec `res.send()` par rapport à l'utilisation directe de `res.statusCode`, `res.setHeader` et `res.end()` du module `http`.

Lancer et tester votre application

Pour lancer votre première application Express, retournez dans votre terminal (en étant toujours à la racine de votre projet `mon-app-express`) et exécutez la commande :

node app.js

Si tout s'est bien passé, vous devriez voir le message : `Application Express démarrée sur http://localhost:3000`.

Ouvrez maintenant votre navigateur et allez à l'adresse `http://localhost:3000`. Vous devriez voir le message : `Bonjour depuis Express !`.

Félicitations ! Vous avez installé Express.js, configuré une application minimale, défini une première route et lancé votre serveur. C'est la base sur laquelle nous allons maintenant construire en explorant plus en détail le routage, les middlewares et les autres fonctionnalités puissantes d'Express.