Як перетворити асинхронний процес «натискання посилання в електронному листі» на детермінований набір тестів, готовий до інтеграції з системою безперервної інтеграції (CI), який при цьому зберігає орієнтованість на людину в процесі забезпечення якості.
1. Чому перевірка електронної пошти є проблемною точкою в процесі забезпечення якості
Активація через електронну пошту (посилання для реєстрації, одноразові коди для скидання пароля, коди для двофакторної автентифікації) перебуває на перетині трьох незалежних систем:
| Шар | Типові обов’язки |
|---|---|
| Інтерфейс браузера | Користувач заповнює форму та натискає кнопку Надіслати підтвердження. |
| Бекенд | Створює токен, зберігає його та надсилає електронний лист через SMTP-сервіс. |
| Провайдер поштової скриньки | Отримує повідомлення та надає до нього доступ через API (наприклад, MailSlurp, Mailosaur, Restmail). |
Збій у будь-якому шарі може порушити весь шлях користувача, проте ці три шари часто тестують окремо. Мок поштового сервісу приховує затримки доставки, помилки форматування або помилки генерації токенів. Для команди контролю якості, яка повинна гарантувати, що реальний користувач зможе пройти весь шлях взаємодії, наскрізний (E2E) тест, що охоплює всі три рівні, є незамінним.
Playwright вже пропонує потужне поєднання засобів автоматизації браузера та вбудованого модуля request для HTTP-запитів, що робить його ідеальним вибором для цього шаблону. Складність полягає не в інструментарії, а в асинхронній межі: тест повинен очікувати на повідомлення, яке може надійти через кілька секунд, при цьому забезпечуючи швидкість, надійність та безпеку паралельного виконання набору тестів.
2. Основний шаблон проектування
Цей шаблон можна розкласти на шість повторно використовуваних кроків, які разом забезпечують детермінований тест:
- Створіть унікальну одноразову папку «Вхідні» — це гарантує ізоляцію між паралельними робочими процесами.
- Запустіть дію «Надіслати електронний лист» у браузері (або через API).
- Опитуйте API поштової скриньки з обмеженим часом очікування — детерміноване очікування замість
sleep. - Зіставте отримане повідомлення з тестовим екземпляром (тема, адресат, мітка часу).
- Витягніть токен підтвердження (посилання або OTP) безпечним способом, перевірте його формат та захистіть від повторного відтворення.
- Виконайте крок перевірки у браузері та підтвердьте кінцевий стан облікового запису.
Кожен крок можна інкапсулювати в невеликий допоміжний модуль, що дозволяє повторно використовувати один і той самий код у позитивних, негативних і безпекових сценаріях.
3. Покрокове впровадження
Нижче наведено практичний покроковий опис, який можна скопіювати в набір тестів Playwright. У прикладі використовується MailSlurp, але будь-яка тимчасова поштова скринька, що працює через API (Mailosaur, Restmail тощо), працює таким самим чином.
3.1. Створити унікальну папку «Вхідні»
import { test, expect, request } from '@playwright/test';
import MailSlurp from 'mailslurp-client';
test.describe('Email verification flow', () => {
let inboxId: string;
let emailAddress: string;
const ms = new MailSlurp({ apiKey: process.env.MAILSLURP_API_KEY! });
test.beforeEach(async () => {
const inbox = await ms.createInbox(); // disposable inbox
inboxId = inbox.id;
emailAddress = inbox.emailAddress;
});
test.afterEach(async () => {
await ms.deleteInbox(inboxId); // clean up even on failure
});Чому це важливо: Свіжа папка вхідних повідомлень дозволяє уникнути конфліктів, коли набір тестів виконується паралельно на агентах CI. Ідентифікатор папки вхідних повідомлень також є природним ключем кореляції для подальшого опитування.
3.2. Виконати дію в інтерфейсі користувача
test('user can activate account via email link', async ({ page }) => {
await page.goto('https://app.example.com/signup');
await page.fill('[name="email"]', emailAddress);
await page.fill('[name="username"]', `user_${inboxId}`);
await page.fill('[name="password"]', 'Password123!');
await page.click('button[type=submit]');Тепер тест точно відтворює дії реального користувача. Імітація роботи поштового сервісу тут не використовується; серверна частина спробує надіслати справжнє повідомлення на тимчасову адресу.
3.3. Детерміноване опитування
const timeoutMs = 30_000; // generous but bounded
const start = Date.now();
let email;
while (Date.now() - start < timeoutMs) {
const emails = await ms.getEmails(inboxId, { limit: 1, unreadOnly: true });
if (emails.length) {
email = emails[0];
break;
}
await new Promise(r => setTimeout(r, 1_000)); // 1‑second back‑off
}
expect(email).toBeDefined(); // fail fast if not deliveredДетермінований режим проти фіксованого режиму очікування: замість жорсткого await page.waitForTimeout(5000) цикл перевіряє поштову скриньку щосекунди, доки не з’явиться повідомлення або не закінчиться час очікування. Такий підхід адаптується до затримок у мережі та забезпечує максимально швидке виконання тесту, якщо електронний лист надійде раніше.
3.4. Встановити взаємозв’язок із повідомленням
// Basic correlation checks – can be extended with sender or custom headers
expect(email!.subject).toContain('Verify your account');
expect(email!.to).toBe(emailAddress);Кореляція запобігає випадковому використанню повідомлення, що залишилося від попереднього запуску. Додавання унікального ідентифікатора (наприклад, UUID, вбудованого у запит на реєстрацію) до тексту листа забезпечує ще більшу надійність.
3.5. Безпечне вилучення токенів
const linkMatch = email!.body?.match(/https:\/\/app\.example\.com\/activate\?token=[A-Za-z0-9_-]+/);
expect(linkMatch).not.toBeNull();
const activationLink = linkMatch![0];Регулярний вираз перевіряє, чи витягнутий рядок має вигляд правильної URL-адреси для активації. Якщо у процесі використовується одноразовий пароль (OTP) замість посилання, можна застосувати подібний шаблон (\b\d{6}\b).
3.6. Повна перевірка та підтвердження
await page.goto(activationLink);
await expect(page).toHaveURL(/.*\/dashboard/);
await expect(page.locator('text=Welcome')).toBeVisible();
});
});На цьому етапі тест пройшов шлях Інтерфейс користувача → Бекенд → Поштова скринька → Інтерфейс користувача і перевірив кінцевий стан. Цю ж схему можна використовувати для скидання пароля, підтвердження зміни адреси електронної пошти або будь-якого іншого процесу, що базується на токені, надісланому електронною поштою.
4. Розширення шаблону для крайніх випадків
4.1. Перевірка терміну дії
Ідея для тестування: Після отримання токена навмисно зачекайте довше, ніж встановлений термін дії (наприклад, 10 хвилин), перш ніж його використовувати. В інтерфейсі користувача має з’явитися повідомлення про помилку «посилання втратило чинність». Можна використовувати ту саму логіку перевірки, змінюючи лише час очікування.
4.2. Захист від повторного відтворення
Ідея для тестування: Двічі використати одне й те саме посилання для активації. Перше відвідування має відбутися успішно; друге — має бути відхилено з повідомленням «вже використано». Це підтверджує, що серверна частина системи анулює токен після його використання.
4.3. Негативні сценарії
Неправильний одержувач: Надіслати запит на реєстрацію на адресу, яка навмисно вказана з помилкою, і переконатися, що протягом встановленого часу очікування електронного листа не надійде. Недійсний токен: Змініть один символ у витягнутій URL-адресі та переконайтеся, що сервер повертає відповідь із кодом 400 (недійсний токен).
Ці сценарії мають важливе значення для контролю якості, орієнтованого на безпеку, і їх можна реалізувати за допомогою тих самих допоміжних утиліт.
5. Паралельне виконання та докази CI
Коли набір тестів виконується на платформі безперервної інтеграції (GitHub Actions, Azure Pipelines тощо), зазвичай запускається велика кількість робочих процесів. Наявність окремої папки вхідних повідомлень для кожного тесту усуває взаємовплив між тестами. Крім того:
| Аспект CI | Як це вирішується за допомогою шаблону |
|---|---|
| Синхронізація | Обмежене опитування з настроюваним часом очікування; у журналах фіксується фактична тривалість очікування. |
| Докази | Збережіть вихідні дані електронного листа як артефакт (ms.getEmailRaw(email.id)), щоб рецензенти могли точно побачити, що саме було надіслано. |
| Очищення ресурсів | Команда afterEach видаляє папку «Вхідні», запобігаючи вичерпанню квоти в службі поштових скриньок. |
| Швидкість | Лише деякі тести активації за позитивним сценарієм вимагають повної верифікації електронної пошти; інші тести реєстрації можуть ґрунтуватися на перевірках API нижчого рівня, як це передбачено найкращими практиками спільноти. |
6. Включення агентів штучного інтелекту в процес
У сучасних продуктах дедалі частіше вбудовуються агенти штучного інтелекту, які можуть ініціювати дії з електронною поштою (наприклад, «Попроси мого помічника скинути мій пароль»). Тестування таких взаємодій додає два нових аспекти:
- Відповідність запиту → дії – Чи правильно ШІ перетворює запит природною мовою на виклик API на сервері, який надсилає електронний лист?
- Перевірка результату — Чи відповідає зміст електронного листа намірам ШІ (наприклад, чи вказано правильне ім’я користувача)?
6.1. Практичний приклад
test('ШІ can request a password reset', async ({ page }) => {
// 1. Log in and open the chat widget
await page.goto('https://app.example.com');
await page.fill('#chat-input', 'Reset my password, please');
await page.press('#chat-input', 'Enter');
// 2. Wait for the ШІ’s confirmation message
await expect(page.locator('.chat-bubble')).toContainText('I have sent a reset link to');
// 3. Extract the email address mentioned by the ШІ (if any) or use the test user’s address
const targetEmail = emailAddress; // from the disposable inbox created earlier
// 4. Follow the same polling/extraction steps as before
// ... (reuse the helper functions)
});Цей самий робочий процес poll‑extract‑verify перевіряє, чи обробка природної мови штучним інтелектом у підсумку призводить до формування правильного електронного листа. Оскільки штучний інтелект може використовувати недетерміновані формулювання, тестування має зосереджуватися на спостережуваних результатах (отримання електронного листа, дійсність токена), а не на точній транскрипції чату.
7. П’ять конкретних запитань, які слід поставити фахівцям із забезпечення якості під час оцінки агента штучного інтелекту
- Виявлення намірів — Чи надійно агент розпізнає всі необхідні наміри (наприклад, «скинути пароль», «змінити електронну адресу») незалежно від варіацій формулювань та мови користувача?
- Обробка помилок — Як реагує агент, коли сервіс електронної пошти на стороні сервера виходить з ладу або повертає несподівану помилку?
- Аудит безпеки — Чи трапляється, що агент розкриває конфіденційні дані (токен, імена користувачів) у своїх повідомленнях у чаті, і чи запобігається таке розкриття на рівні проектування?
- Узгодженість стану — чи після того, як агент ініціює надсилання електронного листа, система правильно позначає запит як такий, що очікує на обробку, та чи коректно обробляє дублікати запитів?
- Спостережуваність — Чи реєструються дії, згенеровані штучним інтелектом, таким чином, щоб тестувальник міг простежити шлях від запиту користувача до вихідного електронного листа (наприклад, за допомогою ідентифікаторів кореляції)?
Відповіді на ці питання, отримані за допомогою поєднання ручних дослідницьких сесій та описаного вище автоматизованого процесу, дають збалансоване уявлення про надійність штучного інтелекту.
8. У яких випадках автоматизація допомагає
Автоматизація не замінює людське судження, але вона чудово справляється з:
| Сфера | Переваги автоматизації |
|---|---|
| Регресія | При кожному коміті повторно запускати повний цикл «інтерфейс користувача → поштова скринька», щоб на ранній стадії виявляти регресії. |
| Межі продуктивності | Виміряйте час від натискання кнопки в інтерфейсі користувача до отримання електронного листа; позначайте відхилення, що перевищують порогове значення. |
| Перевірки безпеки | Систематично відтворюйте сценарії повторного відтворення, несанкціонованого втручання або використання токенів із вичерпаним терміном дії, які було б занадто трудомістко виконувати вручну. |
| Збір даних | Збирайте необроблені дані електронних листів, HTTP-траси та журнали браузерів для подальшого аналізу інцидентів. |
| Паралельне виконання | Запускайте той самий тест у різних браузерах та конфігураціях без додаткових ручних зусиль. |
Головне — поєднувати ці автоматизовані перевірки з дослідницькими сесіями, під час яких досліджуються нюанси спілкування ШІ, доступність інтерфейсу користувача та реальний досвід користувачів.
9. Розробка тестів, орієнтованих на людину, та аналіз ризиків
Навіть за наявності надійної автоматизованої платформи команда із забезпечення якості все одно повинна:
- Перевірка тестових даних – Переконайтеся, що домен одноразової поштової скриньки не заблоковано спам-фільтрами, які використовуються в робочому середовищі.
- Перевірка змісту електронного листа – Людина повинна підтвердити, що повідомлення відповідає вимогам щодо брендингу, мовного оформлення та законодавчим вимогам (наприклад, інформація в нижньому колонтитулі відповідно до GDPR).
- Оцінка ризику, пов’язаного з часом – У виробничому середовищі доставка електронних листів може затримуватися через зовнішні фактори; час очікування тесту повинен враховувати найгірший прийнятний варіант користувацького досвіду, а не лише найшвидше виконання CI.
- Урахування особливостей роботи в різних регіонах — деякі поштові сервіси по-різному обробляють повідомлення залежно від IP-адреси відправника; ручне тестування з іншого регіону може виявити приховані проблеми.
Розглядаючи автоматизований процес як основу та доповнюючи його ручною дослідницькою роботою, команди досягають як швидкості, так і глибини.
10. Висновок
Комплексне тестування перевірки електронної пошти є класичною задачею контролю якості, оскільки охоплює інтерфейс користувача, серверну частину та зовнішній поштовий сервіс. Завдяки автоматизації браузера в Playwright та його вбудованій HTTP-фікстурі request схема унікальна одноразова поштова скринька → детерміноване опитування → безпечне вилучення токена → верифікація стає як повторюваною, так і сумісною з CI. Розширення цього ж робочого процесу на ШІ-агентів, які ініціюють дії з електронною поштою, дозволяє зберегти той самий рівень впевненості, водночас виявляючи нові аспекти ризику, які можна повною мірою оцінити лише шляхом ручного дослідження.
Поєднуючи детерміновану автоматизацію з ретельно продуманим ручним тестуванням, команди із забезпечення якості можуть забезпечити надійний досвід активації, захистити систему від регресій у безпеці та підтримувати цикл зворотного зв’язку на достатньо високому рівні для сучасних, динамічних конвеєрів розробки.
Джерела
- Original article: “How to Test Email Verification Flows with Playwright” – DEV Community. https://dev.to/alaeddine_rihane_8dec187a/how-to-test-email-verification-flows-with-playwright-4b7b
- Playwright testing documentation. https://playwright.dev/docs/api-testing
- End‑to‑End Testing Beyond the Browser: Email Verification with Playwright – DEV Community. https://dev.to/dsheiko/end-to-end-testing-beyond-the-browser-email-verification-with-playwright-3995
- Playwright Email Testing: Verify Notifications End‑to‑End – TestDino. https://testdino.com/blog/playwright-email-testing
- Playwright email testing and email verification – MailSlurp blog. https://www.mailslurp.com/blog/playwright-email-testing
- Automate Email Verification Testing with Playwright, Cypress & Selenium – I Love TempMail. https://ilovetempmail.com/blog/automate-email-verification-testing

Залишити коментар
Поділіться думкою про статтю. Реєстрація не потрібна.
Коментарі
Завантаження коментарів…