codeceptjs-tempmail
v0.4.7
Published
Codecept Helper using temp-mail.ru api for email testing
Downloads
4
Maintainers
Readme
Table of Contents
Intro
Codecept Helper with that consumes the temp-mail.ru api for test scenarios that require email interaction. An example scenario can be found below
Config
Add to codecept.conf.js
with:
exports.config = {
helpers: {
Nightmare: {
url: "http://localhost"
},
Mailbox: {
"require": "node_modules/codeceptjs-tempmail"
}
}
/*...some config*/
}
or to codecept.json
with:
{
"helpers": {
"Nightmare": {
"url": "http://localhost"
},
"Mailbox": {
"require": "node_modules/codeceptjs-tempmail"
}
}
}
Mailbox
Extends Helper
Helper with disposable mailbox api that is availible within test execution.
Parameters
config
constructor
Parameters
config
Object configuration can be overridded by values found incodecept.json
createMailbox
Parameters
name
string? Optional string to be used in mainlbox address
Examples
I.createMailbox('testmail') //{address: "[email protected]", messages: {error: "there are no messages yet"}}
I.createMailbox() //{address: "[email protected]", messages: {error: "there are no messages yet"}}
Returns object Creates a mailbox object and checks for mail before returning.
deleteLatestMessage
Parameters
mailbox
object? Takes a mailbox object and detletes the last (i.e. most recent) value from messages and the mail server. (optional, defaultthis.mailbox
)
getMailbox
Parameters
debug
boolean Logs the mailbox out to the console to aid debugging. (optional, defaultfalse
)
Returns any The mailbox object in it's current state, i.e. if you have called the methods elsewhere in this file without arguments, the Mailbox object is updated internally. This returns it.
getMailbox
Returns any The mailbox object in it's current state, i.e. if you have called the methods elsewhere in this file without arguments, the Mailbox object is updated internally. This returns it.
getLatestMessage
Parameters
mailbox
any {object=} mailbox - Takes a mailbox object and assigns amailbox.latest
object with the last (i.e. most recent) value in the messages array returned from the server. (optional, defaultthis.mailbox
)
getMailById
Parameters
id
string Takes a mail_id string and returns it from themailbox.messages
array
waitForMessage
Parameters
mailbox
object? Takes a mailbox object and makes 10 attempts at retrieving messages from the server. Once a suitible response is recieved themailbox.messages
andmailbox.latest
are updated. (optional, defaultthis.mailbox
)
Example
Feature("Create Account");
Scenario("Create account email", function* (I) {
// Process initiated from an email with a link to create an account.
I.waitForMessage();
mailbox = yield I.getMailbox();
//I.grabRegex() should be replaced with a regex function that extracts a value from the supplied email text.
createLink = yield I.grabRegex(null, mailbox.latest.mail_text_only);
});
Scenario("Create Account", (I) => {
I.amOnPage(createLink);
I.waitForText("Create a New Account");
I.click("Create a New Account");
I.fillField("password", "Som3Rand0mPa55");
I.fillField("confirmPassword", "Som3Rand0mPa55");
I.click("Create Account");
I.waitForText("Activate Your Account");
I.see("Activate Your Account");
I.see(`An email has been sent to ${mailbox.address}`);
I.deleteLatestMessage(mailbox);
//Delete can take a few seconds to register with the temp-mail server, it's recommended that an arbitrary wait is used in your scenario.
I.wait(10);
});
Scenario("Activation Email", function* (I) {
// Wait for new activation email
I.waitForMessage();
mailbox = yield I.getMailbox();
activationLink = yield I.grabRegex(null, mailbox.latest.mail_text);
});
Scenario("5862 Login", (I) => {
I.amOnPage(activationLink);
I.waitForText("Email Address Verified");
I.see("Login");
I.fillField("username", mailbox.address);
I.fillField("password", "Som3Rand0mPa55");
I.click("Login");
I.deleteLatestMessage(mailbox);
I.wait(10);
I.getMessages();
});