Nodemailer JavaScript (Node.js) : guide complet avec exemples

Qu'est-ce que Nodemailer et pourquoi l'utiliser ?

Nodemailer est un module pour Node.js qui permet d'envoyer des emails depuis votre application JavaScript. C'est l'une des bibliothèques les plus populaires et les plus stables de l'écosystème Node.js pour la gestion des emails. Elle offre une API simple mais puissante pour créer et envoyer des messages via différents transports (SMTP, Sendmail, Amazon SES, etc.).

Pourquoi utiliser Nodemailer ?

• Automatisation des notifications : Envoi d'emails d'inscription, de réinitialisation de mot de passe, de confirmation de commande, etc.
• Campagnes emailing : Création de newsletters et de campagnes marketing (avec précaution pour éviter les spams).
• Formulaires de contact : Envoi de messages depuis les formulaires de votre site web.
• Monitoring et logs : Alertes administrateur en cas d'erreurs critiques dans l'application.
• Flexibilité : Support des templates HTML, pièces jointes, images intégrées et différents encodages.

Nodemailer simplifie la complexité des protocoles email (SMTP, POP3, IMAP) et fournit une interface unifiée et intuitive.

Installation de Nodemailer

L'installation de Nodemailer se fait via le gestionnaire de paquets npm (Node Package Manager). Assurez-vous d'avoir Node.js installé (version 12 ou supérieure).

Ouvrez un terminal dans le dossier racine de votre projet et exécutez la commande :

npm install nodemailer

Une fois l'installation terminée, vous pouvez importer la bibliothèque dans votre code :

const nodemailer = require('nodemailer');

Pour les projets utilisant les modules ES (avec "type": "module" dans package.json), utilisez l'import :

import nodemailer from 'nodemailer';

Démarrage rapide : envoyer votre premier email

La façon la plus simple d'envoyer un email est d'utiliser un serveur SMTP. Dans cet exemple, nous utiliserons le service Gmail. Important : Pour utiliser Gmail, vous devez créer un "mot de passe d'application" (App Password) ou utiliser OAuth2. Votre mot de passe Gmail standard ne fonctionnera pas en raison des paramètres de sécurité de Google.

const nodemailer = require('nodemailer');

// 1. Créer le transport (méthode d'envoi)
const transporter = nodemailer.createTransport({
    service: 'gmail',
    auth: {
        user: 'votre-email@gmail.com', // Votre email
        pass: 'votre-mot-de-passe-application' // Mot de passe d'application
    }
});

// 2. Configurer l'email
const mailOptions = {
    from: 'votre-email@gmail.com',
    to: 'destinataire@example.com',
    subject: 'Bonjour depuis Nodemailer !',
    text: 'Ceci est un email de test envoyé avec Nodemailer.'
};

// 3. Envoyer l'email
transporter.sendMail(mailOptions, (error, info) => {
    if (error) {
        return console.log('Erreur :', error);
    }
    console.log('Email envoyé :', info.messageId);
    console.log('URL de prévisualisation :', nodemailer.getTestMessageUrl(info));
});

Ce code crée un transport pour Gmail, forme un email texte simple et l'envoie. En cas de succès, vous verrez l'ID du message dans la console.

Méthodes et fonctions principales de Nodemailer

Examinons en détail les méthodes clés fournies par la bibliothèque.

1. nodemailer.createTransport(options)

Fonction : Crée un objet de transport — c'est la configuration principale qui détermine comment l'email sera envoyé (via quel serveur et avec quelles informations d'identification).

Paramètres :

• options (Object) : Objet de configuration. Propriétés principales :
  • host (String) : Adresse du serveur SMTP (ex : 'smtp.gmail.com').
  • port (Number) : Port du serveur (généralement 465 pour SSL, 587 pour TLS).