mailtrap-email-testing
v1.0.1
Published
The `mailtrap-email-testing` package allows you to send emails using the Mailtrap Email Testing API. Follow the steps below to use the package effectively.
Downloads
5
Readme
mailtrap-email-testing Package Usage Guide
The mailtrap-email-testing package allows you to send emails using the Mailtrap Email Testing API. Follow the steps below to use the package effectively.
Prerequisites
Before getting started, make sure you have the following prerequisites:
- Node.js installed on your machine
- Mailtrap API credentials (API URL, API Token, Inbox ID)
- A basic understanding of JavaScript and Node.js
Installation
To use the mailtrap-email-testing package, you need to install it as a dependency in your project. Open your terminal and navigate to your project directory. Then, run the following command:
npm install mailtrap-email-testingGetting Started
To start using the mailtrap-email-testing package, follow these steps:
- Import the package and create an instance of the
EmailSenderclass:
const { EmailSender } = require("mailtrap-email-testing");
const emailSender = new EmailSender({
apiUrl: process.env.API_URL,
apiToken: process.env.API_TOKEN,
inbox_id: process.env.INBOX_ID,
});- Define the required parameters for sending an email:
const params = {
senderName: "Example Sales Team",
senderEmail: "[email protected]",
recipientName: "John Doe",
recipientEmail: "[email protected]",
subject: "Your Example Order Confirmation",
text: "Congratulations on your order no. 1234",
html: "<html><body><h1>Order Confirmation</h1><p>Congratulations on your order no. 1234</p></body></html>",
attachments: [
{
content: "Base64-encoded content",
filename: "attachment.txt",
type: "text/plain",
disposition: "attachment",
},
],
};Make sure to replace the placeholder values with your actual email data.
- Call the
sendmethod to send the email:
emailSender.send(params);Customization
You can customize the behavior of the EmailSender class by providing the Mailtrap API credentials when creating an instance of the EmailSender class:
const emailSender = new EmailSender({
apiUrl: "https://api.mailtrap.io",
apiToken: "YOUR_API_TOKEN",
inboxId: "YOUR_INBOX_ID",
});Replace 'YOUR_API_TOKEN' with your Mailtrap API token and 'YOUR_INBOX_ID' with the appropriate inbox ID.
Error Handling
If an error occurs during the email sending process, the send method will throw an error. You can handle errors using a try-catch block:
try {
// Code for sending email
} catch (error) {
console.error("Error sending email:", error);
}That's it! You can now use the mailtrap-email-testing package to send emails using the Mailtrap Email Testing API. Remember to replace the placeholder values and ensure that you have the necessary API credentials before using the package.
If you encounter any issues or have any questions, refer to the package documentation or seek assistance from the Mailtrap support team.
Happy emailing!