API Open Source Nodd.js pour la lecture et l'envoi d'e-mails

Premiers pas avec Nodemailer

La façon recommandée d'installer Nodemailer est d'utiliser NPM. Veuillez utiliser la commande suivante pour une installation fluide.

npm install nodemailer
 

Envoi d'un message électronique depuis Node.js

L'API de messagerie open source Nodemailer permet aux développeurs de logiciels de créer et d'envoyer des messages électroniques depuis une application Node.js sans aucune dépendance externe. L'API prend en charge divers mécanismes de transport, permettant aux développeurs de choisir la meilleure méthode pour envoyer des e‑mails. Les méthodes de transport les plus courantes incluent le transport SMTP, la prise en charge OAuth2 ou le transport direct. Elle prend en charge l'ajout de pièces jointes aux e‑mails, l'intégration d'images jointes pour le contenu HTML, l'envoi d'e‑mails à plusieurs utilisateurs, etc. Voici un exemple simple qui montre comment les développeurs peuvent utiliser le transport SMTP pour envoyer un message électronique depuis une application Node.js.

 
const nodemailer = require('nodemailer');

// Configure the SMTP transport
let transporter = nodemailer.createTransport({
    host: 'smtp.example.com',
    port: 587,
    secure: false, // true for 465, false for other ports
    auth: {
        user: 'your-email@example.com', // your SMTP username
        pass: 'your-email-password' // your SMTP password
    }
});

// Define the email options
let mailOptions = {
    from: 'your-email@example.com', // sender address
    to: 'recipient@example.com', // list of receivers
    subject: 'Hello from Nodemailer', // Subject line
    text: 'This is a test email sent using Nodemailer', // plain text body
    html: 'This is a test email sent using Nodemailer' // html body
};

// Send the email
transporter.sendMail(mailOptions, (error, info) => {
    if (error) {
        return console.log('Error: ', error);
    }
    console.log('Message sent: %s', info.messageId);
    console.log('Preview URL: %s', nodemailer.getTestMessageUrl(info));
});
 

Envoyer des e‑mails avec du contenu riche depuis les applications Node.js

L'API Nodemailer permet la création de contenus d'e-mails riches, prenant en charge les formats texte brut et HTML au sein des applications Node.js. Cela permet aux développeurs de logiciels de concevoir des e-mails visuellement attrayants pouvant inclure du style, des images et même du contenu interactif. En utilisant l'API avec des moteurs de templates comme Handlebars ou EJS, les développeurs peuvent créer des modèles d'e-mails dynamiques et basés sur les données. C’est idéal pour envoyer des messages personnalisés, où le contenu peut s'adapter en fonction des données de l'utilisateur. L'API prend en charge les pièces jointes, rendant possible l'envoi de fichiers tels que des PDF, des images ou tout autre type de fichier avec l'e-mail.

En-têtes personnalisés et images intégrées

Pour une personnalisation avancée des e‑mails, l'API Nodemailer permet aux développeurs de logiciels d'inclure des en‑têtes personnalisés et des images intégrées dans les applications Node.js. Cette fonctionnalité est particulièrement utile pour le branding et la personnalisation, garantissant que les e‑mails correspondent à l'apparence et à l'identité de l'application. Les en‑têtes personnalisés peuvent être utilisés pour définir des métadonnées spécifiques du message, tandis que les images intégrées rendent votre e‑mail visuellement attrayant en affichant les images en ligne. Vous trouverez ci‑dessous un exemple complet illustrant l'envoi d'un e‑mail avec des en‑têtes personnalisés et une image intégrée.

 
const nodemailer = require('nodemailer');
const path = require('path');

// Create a transporter object using SMTP transport
let transporter = nodemailer.createTransport({
    service: 'gmail',
    auth: {
        user: 'your-email@gmail.com',
        pass: 'your-email-password'
    }
});

// Define the email options, including custom headers and an embedded image
let mailOptions = {
    from: 'your-email@gmail.com',
    to: 'recipient@example.com',
    subject: 'Custom Headers and Embedded Images in Nodemailer',
    html: `
Bienvenue !
           
Ce courriel contient des en‑têtes personnalisés et une image intégrée.
           `,
    headers: {
        'X-Custom-Header': 'CustomHeaderValue',
        'X-Mailer': 'Nodemailer 6.4.11'
    },
    attachments: [
        {
            filename: 'image.jpg',
            path: path.join(__dirname, 'path_to_image/image.jpg'),
            cid: 'unique@nodemailer.com' // same cid as in the HTML above
        }
    ]
};

// Send the email
transporter.sendMail(mailOptions, (error, info) => {
    if (error) {
        return console.error('Error sending email:', error);
    }
    console.log('Email sent successfully:', info.response);
});