Email тестирование

WebdriverIO — это мощный инструмент для автоматизированного тестирования веб-приложений. Одной из популярных задач является тестирование функциональности отправки и получения email-сообщений в приложениях. В этой главе рассматриваются основные подходы и шаги, которые помогут настроить и эффективно использовать WebdriverIO для тестирования email-функционала.

Установка WebdriverIO

Для начала необходимо установить WebdriverIO и все необходимые зависимости для работы с почтовыми сервисами. Это можно сделать с помощью npm:

npm install --save-dev @wdio/cli @wdio/local-runner @wdio/mocha-framework @wdio/chromedriver-service

Кроме того, для взаимодействия с почтовыми сервисами может потребоваться настройка дополнительного плагина или библиотеки, например, для работы с API почтовых сервисов (SMTP, IMAP).

Интеграция с почтовыми сервисами

Для тестирования отправки и получения email-сообщений нужно взаимодействовать с почтовыми сервисами. Примером может служить использование IMAP или SMTP для отправки и получения писем. Однако WebdriverIO напрямую не работает с почтовыми протоколами, поэтому для таких задач следует подключить сторонние библиотеки.

Одной из таких библиотек является Nodemailer, используемая для отправки писем через SMTP. Для получения писем можно использовать imap-simple — библиотеку для работы с IMAP-серверами.

Пример настройки Nodemailer для отправки письма:

const nodemailer = require('nodemailer');

// Создание транспортера
const transporter = nodemailer.createTransport({
  service: 'gmail',
  auth: {
    user: 'your-email@gmail.com',
    pass: 'your-email-password'
  }
});

// Определение письма
const mailOptions = {
  from: 'your-email@gmail.com',
  to: 'recipient-email@example.com',
  subject: 'Тестовое письмо',
  text: 'Это тело тестового письма.'
};

// Отправка письма
transporter.sendMail(mailOptions, (error, info) => {
  if (error) {
    return console.log(error);
  }
  console.log('Сообщение отправлено: ' + info.response);
});

Для получения писем с использованием IMAP можно настроить библиотеку imap-simple. Важно помнить, что для доступа к почтовым ящикам могут понадобиться специфичные настройки безопасности или двухфакторная аутентификация.

Написание тестов

В тестах для проверки функционала email часто проверяется, было ли отправлено письмо, а также его содержимое. Это можно сделать через API почтового сервиса или через проверку интерфейса отправки сообщений на веб-странице.

Пример теста, который проверяет отправку email через интерфейс:

describe('Email тестирование', () => {
  it('Должно отправиться письмо', async () => {
    await browser.url('https://example.com/email');  // URL страницы с формой отправки
    const emailInput = await $('#email');  // Поле для ввода email
    const subjectInput = await $('#subject');  // Поле для ввода темы
    const bodyInput = await $('#body');  // Поле для ввода тела сообщения
    const sendButton = await $('#sendButton');  // Кнопка отправки

    await emailInput.setValue('test@example.com');
    await subjectInput.setValue('Тема тестового письма');
    await bodyInput.setValue('Тело тестового письма');
    
    await sendButton.click();

    const confirmationMessage = await $('#confirmationMessage');  // Сообщение о подтверждении отправки
    await expect(confirmationMessage).toHaveText('Письмо отправлено');
  });
});

В этом примере тестируется интерфейс веб-страницы для отправки email-сообщений. Важно убедиться, что после отправки письма появляется подтверждающее сообщение, которое сообщает пользователю об успешной отправке.

Проверка входящих сообщений

Проверка входящих писем может быть выполнена через подключение к почтовому серверу с помощью IMAP. Используя библиотеку imap-simple, можно настроить тест для получения сообщений. Пример проверки:

const imap = require('imap-simple');

const config = {
  imap: {
    user: 'your-email@gmail.com',
    password: 'your-email-password',
    host: 'imap.gmail.com',
    port: 993,
    tls: true,
  },
};

describe('Проверка входящих писем', () => {
  it('Должно быть получено письмо с заданной темой', async () => {
    const connection = await imap.connect(config);

    const box = await connection.openBox('INBOX');
    const searchCriteria = ['ALL'];
    const fetchOptions = {
      bodies: ['HEADER.FIELDS (FROM SUBJECT DATE)', 'TEXT'],
      struct: true,
    };

    const messages = await connection.search(searchCriteria, fetchOptions);
    const subject = messages[0].parts.filter(part => part.which === 'HEADER.FIELDS (FROM SUBJECT DATE)')[0].body.subject;

    expect(subject).toBe('Тема тестового письма');
    await connection.end();
  });
});

Этот код подключается к почтовому серверу, открывает папку “INBOX” и ищет письма с указанной темой. Такой подход позволяет проверить, что письмо было получено и имеет правильную тему.

Тестирование через сторонние API

Для более сложных сценариев тестирования, когда необходимо проверить работу email-функционала в масштабах всего приложения, может быть полезно использовать сторонние сервисы для отправки и получения писем. Один из популярных сервисов — Mailosaur, который позволяет интегрировать автоматические тесты с API и получать письма через временные почтовые ящики.

Пример использования Mailosaur API для тестирования:

const MailosaurClient = require('mailosaur');
const client = new MailosaurClient('your-api-key');

describe('Тестирование email через Mailosaur', () => {
  it('Должно быть получено письмо с правильной темой', async () => {
    const result = await client.messages.search({
      sentTo: 'your-test-mail@mailosaur.io',
      subject: 'Тема тестового письма',
    });

    expect(result.items.length).toBeGreaterThan(0);
    expect(result.items[0].subject).toBe('Тема тестового письма');
  });
});

Этот подход позволяет автоматизировать тестирование и проверку писем через сторонние сервисы, что полезно для более сложных или распределённых приложений.