راهنمای مبتدیان Node Mailer با Node.js

ارسال ایمیل بخش اساسی بسیاری از برنامه های کاربردی وب است و Node.js یک راه حل قدرتمند ارائه می دهد.

این مقاله به بررسی nodemailer، یک کتابخانه محبوب Node.js می پردازد که ارسال ایمیل از برنامه های شما را ساده می کند.

چه در توسعه وب مبتدی باشید و چه با Node.js آشنا باشید، این راهنما به شما کمک می کند تا با nodemailer شروع کنید و به سوالات رایج پاسخ دهید.

چرا Nodemailer مهم است

Nodemailer یک کتابخانه پر استفاده در اکوسیستم Node.js به دلیل سادگی و تطبیق پذیری است.

این به توسعه دهندگان امکان می دهد بدون زحمت از برنامه های Node.js خود ایمیل ارسال کنند و آن را به ابزاری ضروری برای تأیید کاربر، بازنشانی رمز عبور، اعلان ها و کارهای دیگر تبدیل می کند.

Nodemailer طیف وسیعی از ویژگی ها، از جمله پشتیبانی از خدمات ایمیل مختلف، پیوست ها، محتوای HTML و مدیریت خطا را ارائه می دهد. Nodemailer با API کاربر پسند خود به توسعه دهندگان این امکان را می دهد تا عملکرد ایمیل را به طور یکپارچه در پروژه های خود ادغام کنند.

شروع کار با Nodemailer

برای شروع استفاده از nodemailer، باید آن را به عنوان یک وابستگی در پروژه Node.js خود نصب کنید. ترمینال خود را باز کنید و دستور زیر را اجرا کنید:

npm install nodemailer

هنگامی که nodemailer نصب شد، می توانید شروع به استفاده از آن در برنامه خود کنید. در اینجا یک نمونه از یک اسکریپت ارسال ایمیل اولیه با استفاده از nodemailer آورده شده است

// Require nodemailer
const nodemailer = require('nodemailer');

// Create a transporter object
const transporter = nodemailer.createTransport({
  service: 'gmail',
  auth: {
    user: 'your@email.com',
    pass: 'yourpassword'
  }
});

// Define email options
const mailOptions = {
  from: '"Your Name" <your@email.com>',
  to: 'recipient@email.com',
  subject: 'Subject Line',
  text: 'Plain text content',
  html: '<b>HTML</b> content'
};

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

در کد بالا، ابتدا به nodemailer نیاز داریم و یک آبجکت انتقال دهنده ایجاد می کنیم و سرویس ایمیل و جزئیات احراز هویت را مشخص می کنیم.

سپس گزینه های ایمیل شامل فرستنده، گیرنده، موضوع و محتوا (متن ساده و HTML) را تعریف می کنیم.

در نهایت از شیء انتقال دهنده استفاده می کنیم ارسال ایمیل روشی برای ارسال ایمیل، رسیدگی به هرگونه خطا یا ثبت پاسخ موفقیت آمیز.

نحوه ادغام Nodemailer با جیمیل

ادغام Nodemailer با Google نیاز به پیکربندی حساب جیمیل خود برای اجازه دسترسی از برنامه دارد.

در اینجا یک راهنمای گام به گام برای کمک به شما در ادغام Nodemailer با Google آورده شده است.

اگر قبلاً این کار را نکرده اید، Nodemailer را با اجرای دستور زیر در ترمینال پروژه خود نصب کنید:

npm install nodemailer

اگر قبلاً یک حساب جیمیل ندارید، در https://accounts.google.com/signup یکی ایجاد کنید. این حساب برای ارسال ایمیل از برنامه شما استفاده خواهد شد.

به‌طور پیش‌فرض، Gmail برای محافظت از حساب شما، دسترسی برنامه‌های کمتر امن را مسدود می‌کند. از آنجایی که Nodemailer از SMTP برای ارسال ایمیل استفاده می کند، باید دسترسی به برنامه های کمتر امن را فعال کنید. این مراحل را دنبال کنید:

1. به تنظیمات حساب Google خود در https://myaccount.google.com/ بروید.

1. روی تب “امنیت” در سمت چپ کلیک کنید.
2. به قسمت «دسترسی به برنامه کمتر امن» بروید.
3. گزینه «Allow less safe apps» را روشن کنید. به یاد داشته باشید که این گزینه حساب شما را در برابر دسترسی های غیرمجاز آسیب پذیرتر می کند، بنابراین از آن فقط برای برنامه های توسعه یا قابل اعتماد استفاده کنید.

برای احراز هویت برنامه خود با Gmail، باید یک “گذرواژه برنامه” ایجاد کنید زیرا Nodemailer از احراز هویت مستقیم مبتنی بر رمز عبور پشتیبانی نمی کند. این مراحل را برای ایجاد رمز عبور برنامه دنبال کنید.

1. به تنظیمات حساب Google خود در https://myaccount.google.com/ بروید.
2. روی تب “امنیت” در سمت چپ کلیک کنید.
3. در قسمت «ورود به Google»، گزینه «App Passwords» را پیدا کرده و روی آن کلیک کنید.
4. ممکن است برای اهداف امنیتی از شما خواسته شود که رمز عبور حساب خود را دوباره وارد کنید.
5. در بخش «گذرواژه‌های برنامه»، برنامه‌ای را که می‌خواهید برای آن رمز عبور ایجاد کنید، انتخاب کنید (در صورت وجود «ایمیل» را انتخاب کنید).
6. دستگاه خود را از منوی کشویی انتخاب کنید.
7. بر روی دکمه “تولید” کلیک کنید.
8. Google یک رمز عبور برنامه منحصر به فرد ایجاد می کند. به این رمز عبور توجه کنید، زیرا از آن در برنامه Node.js خود استفاده خواهید کرد.

• Nodemailer را در برنامه خود راه اندازی کنید

اکنون که حساب جیمیل شما پیکربندی شده است، می توانید Nodemailer را در برنامه Node.js خود راه اندازی کنید. در اینجا مثالی از نحوه پیکربندی Nodemailer با اعتبار Gmail آورده شده است:

const nodemailer = require('nodemailer');

const transporter = nodemailer.createTransport({
  service: 'gmail',
  auth: {
    user: 'your@gmail.com',
    pass: 'your-app-password'
  }
});

// Rest of the code for sending emails using Nodemailer

جایگزین کردن ‘your@gmail.com‘ با آدرس ایمیل اکانت جیمیل خود و رمز عبور برنامه شما با رمز عبور برنامه که در مرحله 4 ایجاد کردید.

می توانید یک ایمیل آزمایشی از برنامه Node.js خود ارسال کنید تا بررسی کنید که آیا ادغام به درستی کار می کند یا خیر. از قطعه کد ارائه شده در بخش های قبلی استفاده کنید و آن را سفارشی کنید mailOptions شیء شامل گیرنده، موضوع و محتوای ایمیل باشد.

const mailOptions = {
  from: 'your@gmail.com',
  to: 'recipient@example.com',
  subject: 'Test Email',
  text: 'This is a test email sent from Nodemailer with Google integration.'
};

transporter.sendMail(mailOptions, (error, info) => {
  if (error) {
    console.log(error);
  } else {
    console.log('Email sent: ' + info.response);
  }
});

جایگزین کردن ‘recipient@example.com‘ با آدرس ایمیلی که می خواهید ایمیل آزمایشی را دریافت کنید.

برنامه Node.js خود را اجرا کنید، و اگر همه چیز به درستی تنظیم شده باشد، باید یک پیام موفقیت آمیز مشاهده کنید که نشان می دهد ایمیل ارسال شده است.

تبریک می گویم! شما با موفقیت Nodemailer را با Google ادغام کردید. اکنون می توانید از Nodemailer برای ارسال ایمیل از برنامه Node.js با استفاده از حساب Gmail خود استفاده کنید.

به خاطر داشته باشید که خطاها را مدیریت کنید و مدیریت خطا و ورود به برنامه خود را برای اطمینان از تحویل مطمئن ایمیل پیاده سازی کنید.

علاوه بر این، می‌توانید ویژگی‌های مختلف Nodemailer، مانند ارسال پیوست‌ها، محتوای HTML، و سفارشی‌سازی هدر ایمیل را بررسی کنید تا عملکرد ایمیل خود را افزایش دهید.

توجه: در یک محیط تولید، توصیه می‌شود به جای فعال کردن «اجازه دادن به برنامه‌های امن کمتر» و استفاده از حساب شخصی Gmail خود، از یک ارائه‌دهنده خدمات ایمیل اختصاصی یا سرویس رله SMTP استفاده کنید.

این امر امنیت بهتری را فراهم می کند و تضمین می کند که ایمیل های شما به طور قابل اعتماد تحویل داده شوند.

اگر با مشکلی مواجه شدید یا سؤال دیگری دارید، برای اطلاعات دقیق در مورد قابلیت‌ها و گزینه‌های پیکربندی کتابخانه، به مستندات Nodemailer مراجعه کنید.

سوالات متداول (سوالات متداول)

آیا می توانم از nodemailer با ارائه دهندگان خدمات ایمیل مختلف استفاده کنم؟

بله، nodemailer از ارائه دهندگان خدمات ایمیل مختلف مانند Gmail، Outlook و Yahoo پشتیبانی می کند. می‌توانید شی انتقال‌دهنده را با خدمات و جزئیات احراز هویت مناسب ارائه‌دهنده ایمیل مورد نظر خود پیکربندی کنید.

چگونه می توانم پیوست های ایمیل را با استفاده از nodemailer ارسال کنم؟

Nodemailer به شما این امکان را می دهد که پیوست ها را در ایمیل های خود قرار دهید. می توانید با ارائه یک آرایه در فایل پیوست اضافه کنید mailOptions شی، مسیر فایل، نام فایل و نوع محتوا را مشخص می کند.

آیا امکان ارسال ایمیل های شخصی سازی شده برای چندین گیرنده با استفاده از nodemailer وجود دارد؟

کاملا! Nodemailer انعطاف پذیری را در ارسال ایمیل های شخصی سازی شده به چندین گیرنده فراهم می کند. شما می توانید به صورت پویا تغییر دهید به میدان در mailOptions شیء برای هر گیرنده ایمیل

چگونه می توانم خطاها را هنگام ارسال ایمیل با nodemailer کنترل کنم؟

این transporter.sendMail متد یک تابع تماس را می پذیرد که در آن می توانید خطاها را مدیریت کنید. اگر در فرآیند ارسال ایمیل خطایی رخ دهد، شی خطا به تابع callback ارسال می شود. می‌توانید جزئیات خطا را ثبت کنید یا منطق مدیریت خطای مناسب را پیاده‌سازی کنید.

آیا می توانم محتوای HTML را در ایمیل های خود با nodemailer ارسال کنم؟

بله، nodemailer به شما امکان می دهد علاوه بر متن ساده، محتوای HTML را در ایمیل های خود ارسال کنید. در mailOptions شی، می توانید یک را وارد کنید html ویژگی که حاوی محتوای HTML شما است. می‌توانید از تگ‌های HTML، استایل‌سازی، و جاسازی تصاویر یا پیوندها در ایمیل HTML خود استفاده کنید. Nodemailer ایمیل را با محتوای HTML مشخص شده ارسال می کند.

چگونه می توانم وضعیت تحویل ایمیل را کنترل کنم یا اگر ایمیل با موفقیت ارسال شد، پیگیری کنم؟

Nodemailer اطلاعاتی در مورد وضعیت تحویل ایمیل از طریق اطلاعات شی در تابع callback از transporter.sendMail. این info.response ویژگی حاوی پاسخ ارائه‌دهنده خدمات ایمیل است که معمولاً شامل اطلاعاتی مانند شناسه پیام منحصر به فرد، مهر زمانی و سایر جزئیات است. می توانید از این اطلاعات برای ردیابی وضعیت ایمیل های خود استفاده کنید و در صورت نیاز آن را ثبت یا مدیریت کنید.

آیا می توانم از nodemailer با چارچوب هایی مانند Express.js یا React.js استفاده کنم؟

بله، nodemailer را می توان با فریم ورک های محبوب Node.js مانند Express.js یا React.js ادغام کرد. می‌توانید از nodemailer در کد سمت سرور خود (به عنوان مثال Express.js) برای مدیریت عملکرد ایمیل، مانند ارسال تأییدیه‌های ایمیل یا اعلان‌ها استفاده کنید. در مورد React.js، می توانید از nodemailer در سمت سرور برای ارسال ایمیل بر اساس فرم ارسالی یا اقدامات کاربر استفاده کنید.

آیا برای استفاده از nodemailer با سرویس های ایمیل خاص، مراحل پیکربندی اضافی لازم است؟

برخی از ارائه دهندگان خدمات ایمیل ممکن است برای کار با nodemailer به مراحل پیکربندی اضافی نیاز داشته باشند. برای مثال، ممکن است Gmail برای احراز هویت با nodemailer نیاز به فعال کردن «برنامه‌های کمتر امن» یا تنظیم «گذرواژه برنامه» داشته باشد. توصیه می شود برای اطمینان از پیکربندی مناسب به اسناد ارائه دهنده خدمات ایمیل انتخابی خود مراجعه کنید.

آیا می توان از nodemailer برای ارسال ایمیل یا خبرنامه انبوه استفاده کرد؟

پاسخ: در حالی که Nodemailer می تواند چندین ایمیل را مدیریت کند، اما در اصل برای ایمیل های تراکنشی طراحی شده است تا ارسال ایمیل انبوه یا خبرنامه. برای ارسال ایمیل های انبوه، توصیه می شود از خدمات بازاریابی ایمیلی تخصصی استفاده کنید که ویژگی هایی مانند مدیریت لیست ایمیل، شخصی سازی و تجزیه و تحلیل را ارائه می دهند.

نتیجه

Nodemailer یک کتابخانه قدرتمند و مناسب برای مبتدیان برای ارسال ایمیل از برنامه های Node.js است.

در این مقاله به اصول نود میلر از جمله نصب، ایجاد یک شیء انتقال دهنده، تعیین گزینه های ایمیل و ارسال ایمیل پرداختیم.

ما همچنین به سوالات متداول در مورد ویژگی‌های nodemailer، رسیدگی به خطاها، ارسال محتوای HTML و ادغام با چارچوب‌ها پرداختیم.

با nodemailer، می‌توانید قابلیت‌های ایمیل را به طور یکپارچه در پروژه‌های Node.js خود بگنجانید و به شما امکان می‌دهد اعلان‌ها، ارتباطات کاربر و موارد دیگر را ارسال کنید.

پس ادامه دهید، از قدرت nodemailer استفاده کنید و برنامه های کاربردی وب خود را با قابلیت های قابل اعتماد و کارآمد ارسال ایمیل ارتقا دهید.

اگر این پست را هیجان‌انگیز می‌دانید، پست‌های هیجان‌انگیزتری مانند این را در بلاگ Learnhub پیدا کنید. ما همه چیزهای فنی از رایانش ابری گرفته تا Frontend Dev، Cybersecurity، AI و Blockchain را می نویسیم.

منبع