Gestion des Erreurs avec ExpressJS - Guide pour Débutants

Introduction : Pourquoi Gérer les Erreurs ?

Dans une application, des erreurs peuvent arriver : un utilisateur tape une mauvaise URL, un fichier manque, ou une opération échoue. Sans gestion, l’application peut s’arrêter ou afficher des messages compliqués. Avec ExpressJS, on utilise des "middleware d’erreurs" pour attraper ces problèmes et répondre poliment, comme un gardien qui dit "Désolé, c’est fermé" au lieu de laisser tout s’effondrer.

Étape 1 : Préparer Votre Environnement

Avant de coder, préparons tout ce qu’il faut. Si vous avez suivi les tutoriels précédents, vous avez déjà Node.js et ExpressJS. Voici les étapes :

• Vérifiez Node.js : Ouvrez un terminal et tapez node -v. Si une version apparaît (ex. : v16.13.0), c’est bon. Sinon, téléchargez Node.js sur nodejs.org.
• Créez un dossier projet : Faites un dossier nommé "gestion-erreurs" sur votre ordinateur. Ouvrez-le dans un éditeur comme Visual Studio Code.
• Initialisez le projet : Dans le terminal, allez dans ce dossier avec cd chemin/vers/gestion-erreurs, puis tapez npm init -y. Cela crée un fichier package.json.
• Installez ExpressJS : Tapez npm install express. Nous n’avons besoin que d’Express pour cet exemple.

Étape 2 : Créer une Application avec des Erreurs

Construisons une application simple avec des routes qui peuvent générer des erreurs, puis ajoutons une gestion pour les traiter.

Exemple de Code : Application avec Gestion des Erreurs

Créez un fichier nommé app.js dans votre dossier "gestion-erreurs" et ajoutez ce code :

📋 Copier le code

var express = require('express');
var app = express();

// Route normale
app.get('/', function(req, res) {
    res.send('Bienvenue sur la page d’accueil !');
});

// Route avec une erreur volontaire
app.get('/erreur', function(req, res, next) {
    var erreur = new Error('Quelque chose a mal tourné !');
    next(erreur); // Passe l’erreur au middleware
});

// Route introuvable (404)
app.get('/secret', function(req, res) {
    res.send('Vous avez trouvé la page secrète !'); // Ne sera pas utilisé
});

// Middleware pour gérer les erreurs 404
app.use(function(req, res, next) {
    res.status(404).send('Page non trouvée : ' + req.originalUrl);
});

// Middleware pour gérer toutes les autres erreurs
app.use(function(err, req, res, next) {
    console.error(err.message); // Affiche l’erreur dans le terminal
    res.status(500).send('Erreur serveur : ' + err.message);
});

app.listen(3000, function() {
    console.log('Serveur démarré sur http://localhost:3000');
});
    

Explication Détaillée du Code

Voici chaque partie expliquée très simplement pour les débutants :

• app.get('/', ...); : Une route normale qui fonctionne bien.
• app.get('/erreur', ...); : Une route qui crée une erreur volontaire.
  • new Error(...) : Crée une erreur avec un message.
  • next(erreur) : Envoie l’erreur au middleware suivant.
• app.get('/secret', ...); : Une route qui ne sera pas atteinte (pour tester le 404).
• app.use(function(req, res, next) { ... }); : Middleware pour les erreurs 404.
  • res.status(404) : Définit le statut HTTP à "404" (page non trouvée).
  • req.originalUrl : Montre l’URL demandée par l’utilisateur.
• app.use(function(err, req, res, next) { ... }); : Middleware pour toutes les erreurs.
  • err : L’erreur passée par next(erreur).
  • console.error(err.message) : Affiche l’erreur dans le terminal pour vous aider à comprendre.
  • res.status(500) : Définit le statut à "500" (erreur serveur).
  • err.message : Montre le message de l’erreur à l’utilisateur.

Étape 3 : Tester l’Application

Démarrez le serveur avec node app.js dans le terminal, puis testez :

• http://localhost:3000 : Vous verrez "Bienvenue sur la page d’accueil !".
• http://localhost:3000/erreur : Vous verrez "Erreur serveur : Quelque chose a mal tourné !". Regardez le terminal pour le message d’erreur.
• http://localhost:3000/rien : Vous verrez "Page non trouvée : /rien".

Essayez d’autres URL fausses (ex. : /test) pour voir le 404 en action !

Conclusion

Félicitations ! Vous savez maintenant gérer les erreurs avec ExpressJS. Vous pouvez capturer les erreurs 404 (pages introuvables) et les erreurs serveur pour garder votre application stable et conviviale. Pour aller plus loin, explorez notre prochain tutoriel sur Pratiques de Sécurité avec ExpressJS ou consultez la documentation ExpressJS sur les erreurs.