17370845950

使用 Nodemailer 发送 HTML 邮件模板

本文介绍了如何使用 Nodemailer 发送包含 HTML 模板的邮件。核心在于正确构造 `html` 选项,利用模板字符串和变量插值,动态生成邮件内容。同时,强调了模板字符串的正确使用方式,避免常见的语法错误,并提供可直接使用的代码示例。

使用 Nodemailer 发送 HTML 邮件的关键在于 mailOptions 对象的 html 属性。该属性允许你指定邮件的正文内容为 HTML 格式,从而实现更丰富的邮件样式和布局。以下是如何正确构造和使用 html 属性的详细说明。

使用模板字符串(Template Literals)

JavaScript 的模板字符串提供了一种便捷的方式来构建包含变量的字符串。它们使用反引号 () 包裹字符串,并允许使用${}` 语法插入变量。这对于动态生成 HTML 内容非常有用。

示例代码

const nodemailer = require('nodemailer');

// 假设从请求体中获取了以下数据
const name = 'John Doe';
const email = 'john.doe@example.com';
const phone = '123-456-7890';
const message = 'Hello, this is a test message.';

// 创建一个 Nodemailer 传输器
const transporter = nodemailer.createTransport({
    service: 'gmail', // 或者其他邮件服务提供商
    auth: {
        user: process.env.AUTH_EMAIL, // 你的邮箱地址
        pass: process.env.AUTH_PASSWORD  // 你的邮箱密码或授权码
    }
});

const mailOptions = {
    from: process.env.AUTH_EMAIL,
    to: 'recipient@example.com', // 收件人邮箱地址
    subject: 'Community Partnership Project Contact Form Inquiry',
    html: `
        
            

Name: ${name}


Email: ${email}


Phone: ${phone}


Message: ${message}

` }; // 发送邮件 transporter.sendMail(mailOptions, (error, info) => { if (error) { console.log('Error sending email:', error); } else { console.log('Email sent:', info.response); } });

代码解释

  1. 引入 Nodemailer: const nodemailer = require('nodemailer'); 引入 Nodemailer 库。
  2. 创建传输器 (Transporter): 使用 nodemailer.createTransport() 创建一个传输器,配置邮件服务提供商和认证信息。 请务必使用环境变量或安全的方式存储你的邮箱密码,避免硬编码在代码中。
  3. 构造 mailOptions 对象:
    • from: 发件人邮箱地址。
    • to: 收件人邮箱地址。
    • subject: 邮件主题。
    • html: 使用模板字符串构建的 HTML 内容。 注意反引号的使用,以及 ${variable} 语法来插入变量。
  4. 发送邮件: 使用 transporter.sendMail() 发送邮件。 该方法接受 mailOptions 对象和一个回调函数,用于处理发送结果。

注意事项

  • 转义 HTML 特殊字符: 如果变量中包含 HTML 特殊字符(如 、&),需要进行转义,以避免 HTML 注入攻击。可以使用 escape-html 等库进行转义。
  • CSS 样式: 为了保证邮件在不同客户端上的显示效果一致,建议使用内联 CSS 样式。
  • 邮件服务提供商限制: 某些邮件服务提供商对邮件大小、发送频率等有限制,需要注意遵守相关规定。
  • 安全性: 避免在 HTML 模板中直接拼接用户输入,防止 XSS 攻击。对用户输入进行适当的验证和过滤。
  • 异步操作: transporter.sendMail 是一个异步操作,请确保正确处理回调函数中的错误和成功情况。

总结

使用 Nodemailer 发送 HTML 邮件的关键在于正确使用模板字符串和变量插值,并注意安全性问题。 通过合理地组织 HTML 结构和 CSS 样式,可以创建出美观且功能丰富的邮件模板,提升用户体验。 记得配置正确的邮件服务提供商信息和认证信息,并处理发送邮件过程中的错误。