现在很多网站都需要发送邮件，比如用户注册成功后，需要发送一封欢迎邮件；或者密码重置需要发送邮件验证等等。发送邮件需要与邮件服务器进行交互，而 digger-mailgun 就是一个帮助我们与 Mailgun 邮件服务器交互的 NPM 包。在本文中，我们将会详细介绍如何使用 digger-mailgun。
安装 digger-mailgun
首先，我们需要在项目中安装 digger-mailgun。在终端中运行以下命令：
npm install digger-mailgun
如果你之前没有使用过 Mailgun 服务，你需要先注册一个账号，并在你的 Mailgun 账户中创建一个 “域名”。然后你需要获取你的 Mailgun API 密钥，这个密钥将会在发送邮件时使用。
发送简单邮件
让我们编写一段用 digger-mailgun 发送简单邮件的代码。在你的代码中引入 digger-mailgun：
const mailgun = require('digger-mailgun')({ apiKey: 'YOUR_API_KEY', domain: 'YOUR_DOMAIN' });
上面的代码初始化了一个 mailgun 对象，apiKey 和 domain 都是你的 Mailgun 邮件服务的信息。
接下来，我们可以使用 mailgun 发送一封简单的邮件：
-- -------------------- ---- ------- ----- ---- - - ----- --------------------- --- ------------------------ -------- -------- ----- -------- ---- ------- ------------- -- ----------------------------- -------- ------- ----- - ------------------ ---展开代码
上面的代码创建了一个 data 对象来描述发送的邮件，包括发件人和收件人的地址，邮件主题和正文内容。然后我们给 mailgun.messages() 方法传递该对象参数并设置回调函数，在回调函数中输出发送结果。
发送具有 HTML 内容的邮件
发送具有 HTML 内容的邮件也非常简单，只需要通过设置 data 对象的 html 属性来实现：
-- -------------------- ---- ------- ----- ---- - - ----- --------------------- --- ------------------------ -------- -------- ----- ------------ ---- ------- ------------------ -- ----------------------------- -------- ------- ----- - ------------------ ---展开代码
发送具有附件的邮件
如果我们需要发送一个带有附件的邮件，如下所示：
-- -------------------- ---- ------- ----- ---- - - ----- --------------------- --- ------------------------ -------- -------- ----- -------- ---- ------- -------------- ----------- -------------------- -- ----------------------------- -------- ------- ----- - ------------------ ---展开代码
我们仅需在 data 对象中设置一个 attachment 属性，该属性值是一个包含附件路径的数组。
发送邮件模板
在实际项目中，我们通常需要发送一些带有动态数据的邮件，比如用户注册成功后发送一封欢迎邮件，邮件内容需要包含一些用户信息。这时，我们可以使用邮件模板来完成这个需求。
先看一个基于 digger-mailgun 的邮件模板发送示例：
-- -------------------- ---- ------- ----- ---- - - ----- --------------------- --- ------------------------ -------- ------ ------------------------ ----- ---------- --------------------- ---------------------------- ------------- - -------------------- ------- ------------------- ------ -- ----------- ---- -- ----------------------------- -------- ------- ----- - ------------------ ---展开代码
上面的代码中通过设置 propertyData 对象来传递变量，这些变量将插入到邮件主题和 HTML 内容中。此外，我们还需要在 digger-mailgun 的初始化过程中设置 inline_css 为 true。这是因为默认情况下，Mailgun 不会为我们自动设置内联样式，因此我们需要设置这个属性来主动执行该操作。
结语
在本文中，我们介绍了如何使用 digger-mailgun 在 Node.js 中发送邮件。我们一步步介绍了如何发送简单邮件、HTML 内容的邮件，带有附件的邮件和邮件模板。虽然 Mailgun 是一个好用的邮件发送服务，但是在实现过程中还需要我们自己处理好发送逻辑。我们希望本文能为您提供一些指导和帮助。
来源：JavaScript中文网 ，转载请注明来源 https://www.javascriptcn.com/post/124171
