Як команди із забезпечення якості можуть об’єднати перевірки контрактів, автентифікації, налаштування стану, негативних сценаріїв та побічних ефектів в єдиний набір тестів Playwright — і які існують обмеження, коли тестованою системою є ШІ-агент.
1. Чому варто об’єднати перевірки API та інтерфейсу користувача в одному запуску?
Сучасні додатки часто надають загальнодоступний HTTP-API, який забезпечує роботу як веб-інтерфейсу, так і набору сервісів на основі штучного інтелекту (чат-боти, системи рекомендацій, помічники з написання коду тощо). Коли інженер із забезпечення якості пише наскрізний тест (E2E) за допомогою Playwright, стандартний робочий процес полягає у запуску браузера, взаємодії з користувацьким інтерфейсом та перевірці відображеної сторінки.
Playwright також надає APIRequestContext — вбудований HTTP-клієнт, який може надсилати запити GET, POST, PUT, PATCH, DELETE та HEAD без відкриття браузера. Отже, цей самий засіб виконання тестів може:
- Перевіряти контракт кінцевої точки REST або GraphQL (статус, заголовки, схема JSON).
- Готувати дані на стороні сервера (наприклад, створіть користувача, заповніть базу знань) до початку виконання кроків у графічному інтерфейсі.
- Перевіряти побічні ефекти після виконання послідовності дій у інтерфейсі користувача (наприклад, переконайтеся, що замовлення було збережено).
- Синхронізувати стан автентифікації (файли cookie або токени типу «bearer») між викликами API та браузером, забезпечуючи реалістичність тестового процесу.
У результаті отримуємо єдиний тестовий файл під контролем версій, який перевіряє весь стек, залишаючись при цьому швидким і детермінованим.
2. APIRequestContext у двох словах
| Особливість | Що пропонує Playwright | Практичне значення |
|---|---|---|
| Методи запиту | request.get(), request.post(), … а також загальний request.fetch() | Використовуйте дієслово, яке відповідає кінцевій точці; зовнішня бібліотека HTTP не потрібна. |
| Базова URL-адреса | request.newContext({ baseURL: process.env.API_BASE_URL }) | Уникайте повторення імені хоста; це забезпечує переносимість тестів між різними середовищами. |
| Автентифікація | Встановити заголовок Authorization або створити контекст після сторінки браузера з авторизованим користувачем (await page.context().storageState()) | Використовуйте одну й ту саму сесію для кроків інтерфейсу користувача та API або виконуйте обмін токенами один раз на набір тестів. |
| Допоміжні функції обробки відповідей | response.status(), response.json(), response.text(), response.headers() | Миттєвий доступ до даних, необхідних для перевірки умов контракту. |
| Життєвий цикл | await context.dispose() для звільнення ресурсів; глобальна фікстура request доступний у тестових файлах Playwright | Явне очищення запобігає витоку сокетів під час тривалих циклів безперервної інтеграції. |
Ці можливості описано в офіційному посібнику з тестування API Playwright та в довіднику для класу APIRequestContext:
3. Розробка тестів для звичайних API серверної частини
Тест на відповідність контракту перевіряє, чи дотримується кінцева точка спостережуваного контракту між клієнтом і сервером. За допомогою Playwright можна написати такий лаконічний тест:
test('GET /products returns a paginated list', async ({ request }) => {
const resp = await request.get('/products?page=1&size=10');
expect(resp.status()).toBe(200);
const body = await resp.json();
// Basic shape check – no external схема validator required for simple cases
expect(Array.isArray(body.items)).toBeTruthy();
expect(body.page).toBe(1);
expect(body.size).toBe(10);
});Чому це важливо: Порушення умов контракту виявляються на ранніх етапах (наприклад, відсутність поля після рефакторингу) і захищають подальші тести користувацького інтерфейсу від нестабільних перевірок DOM, які насправді спричинені несправним API.
4. Моделі автентифікації, що зберігаються на всіх етапах роботи з інтерфейсом користувача та API
4.1 Потік токенів на пред’явника
test.use({
// Run once per worker – fetch a token that will be reused
extraHTTPHeaders: async () => {
const tokenResp = await request.post('/auth/login', {
data: { username: 'qa', password: 'secret' },
});
const { accessToken } = await tokenResp.json();
return { Authorization: `Bearer ${accessToken}` };
},
});Хук extraHTTPHeaders вставляє токен у кожен наступний запит, повторюючи те, що SPA надсилає у своєму заголовку Authorization.
4.2 Спільна сесія браузера
test('Create a post via API then view it in the UI', async ({ page, request }) => {
// Log in through the UI once, then export the storage state
await page.goto('/login');
await page.fill('#email', 'qa@example.com');
await page.fill('#password', 'secret');
await page.click('button[type=submit]');
await page.waitForURL('/dashboard');
const storage = await page.context().storageState();
const apiContext = await request.newContext({ storageState: storage });
const createResp = await apiContext.post('/posts', {
data: { title: 'API‑created', body: 'Hello world' },
});
const { id } = await createResp.json();
// Continue with UI verification using the same cookies
await page.goto(`/posts/${id}`);
await expect(page.locator('h1')).toHaveText('API‑created');
});Завдяки повторному використанню файлів cookie браузера запит до API виконується від імені того самого користувача, який увійшов у систему і який згодом керуватиме інтерфейсом користувача. Цей підхід дозволяє уникнути дублювання коду для входу в систему та гарантує послідовне застосування контролю доступу на основі ролей.
5. Налаштування та очищення стану — забезпечення детермінованості тестового середовища
Надійний набір тестів повинен ізолювати кожне виконання. Найпоширеніший підхід полягає в наступному:
- Налаштування — Використовуйте виклики API для створення саме тих даних, які знадобляться інтерфейсу користувача.
- Вправа — Виконайте кроки інтерфейсу користувача, які потрібно перевірити.
- Видалення — Видалити дані, створені на кроці 1, незалежно від результату тесту.
test('User can delete a comment', async ({ page, request }) => {
// 1️⃣ Setup
const commentResp = await request.post('/comments', {
data: { text: 'temporary', postId: 42 },
});
const { id: commentId } = await commentResp.json();
// 2️⃣ Exercise
await page.goto(`/posts/42`);
await page.click(`button[data-comment-id="${commentId}"]`);
await page.click('button.confirm-delete');
await expect(page.locator('.toast')).toContainText('deleted');
// 3️⃣ Cleanup (guarded in finally)
await request.delete(`/comments/${commentId}`).catch(() => {});
});Очищення за схемою finally (або test.afterEach від Playwright) гарантує, що навіть у разі невдалої перевірки інтерфейсу користувача не залишаться «покинуті» записи, які могли б вплинути на подальші тести.
6. Тестування негативного випадку — перевірка того, що API відхиляє некоректні вхідні дані
Позитивні тести є необхідними, але їх недостатньо. Відділ контролю якості також повинен переконатися, що сервер коректно й безпечно відхиляє некоректні запити:
test('POST /orders rejects a negative quantity', async ({ request }) => {
const resp = await request.post('/orders', {
data: { productId: 7, quantity: -3 },
});
expect(resp.status()).toBe(400);
const body = await resp.json();
expect(body.error).toMatch(/quantity must be positive/i);
});Негативні тести можна поєднувати з кроками інтерфейсу користувача, які відображають повідомлення про помилку, що дає подвійне уявлення про збій (відповідь API + зворотний зв’язок, видимий для користувача).
7. Перевірка побічних ефектів, що виходять за межі HTTP-відповіді
Багато кінцевих точок запускають асинхронні операції: надсилання електронного листа, оновлення пошукового індексу або збереження запису, який згодом зчитує сторінка інтерфейсу користувача. Клієнт API Playwright можна використовувати для опитування стану або перевірки цих побічних ефектів:
test('Create a subscription triggers a welcome email', async ({ request }) => {
const subResp = await request.post('/subscriptions', {
data: { email: 'qa@test.com' },
});
expect(subResp.status()).toBe(201);
const { id } = await subResp.json();
// Simple polling loop – in real life use a retry helper
for (let i = 0; i < 5; i++) {
const mailResp = await request.get(`/test-mailbox/qa@test.com`);
const mails = await mailResp.json();
if (mails.some(m => m.subject.includes('Welcome'))) break;
await new Promise(r => setTimeout(r, 1000));
}
// Final assertion
const finalMailResp = await request.get(`/test-mailbox/qa@test.com`);
const finalMails = await finalMailResp.json();
expect(finalMails.some(m => m.subject.includes('Welcome'))).toBeTruthy();
});Перевіряючи спостережуваний результат (лист у тестовій поштовій скриньці), тест підтверджує, що серверна частина виконала передбачений побічний ефект, а не лише повернула значення 201.
8. Тестування кінцевих точок ШІ-агентів за допомогою того самого стека
Агенти штучного інтелекту зазвичай надають доступ до HTTP-кінцевої точки, яка приймає запит, необов’язкові параметри (температура, максимальна кількість токенів) та повертає відповідь. З точки зору забезпечення якості, проблеми полягають у наступному:
- Недетермінований вміст — одна й та сама підказка може призвести до різних формулювань.
- Дотримання політик — відповідь не повинна містити заборонений вміст.
- Використання ресурсів — кількість токенів, затримка та вартість повинні залишатися в межах встановлених обмежень.
Playwright і надалі може бути корисним інструментом:
test('Chat endpoint respects content policy', async ({ request }) => {
const resp = await request.post('/ШІ/chat', {
data: {
prompt: 'Write a joke about cats.',
temperature: 0.7,
},
});
expect(resp.status()).toBe(200);
const { answer, usage } = await resp.json();
// 1️⃣ Simple deterministic check – no profanity word list
const forbidden = ['badword1', 'badword2'];
expect(forbidden.some(w => answer.includes(w))).toBeFalsy();
// 2️⃣ Token usage guard
expect(usage.totalTokens).toBeLessThanOrEqual(150);
// 3️⃣ Optional UI verification – render the answer in the chat UI
await page.goto('/chat');
await page.fill('#prompt', 'Write a joke about cats.');
await page.click('button.send');
await expect(page.locator('.message:last-child')).toContainText(answer);
});Обмеження перевірок, що стосуються виключно HTTP
- Семантична правильність — відповідь, яка проходить фільтр нецензурної лексики, все одно може бути фактично неправильною. Щоб це виявити, потрібні галузеві знання або додаткове джерело інформації, а не лише статус HTTP.
- Планування дій агента — деякі агенти самостійно вирішують, який API викликати наступним. Аналіз кінцевої HTTP-відповіді не гарантує, що проміжна логіка прийняття рішень працювала так, як передбачалося.
- Відхилення затримки — потокові відповіді можуть перериватися; виклик
response.finished()у Playwright лише вказує на те, що транспортний канал було закрито, але не свідчить про те, чи дотримався агент ліміту часу очікування.
Отже, перевірки API слід доповнити наступним:
- Реєстрація внутрішнього ланцюжка рішень агента (якщо служба надає доступ до нього).
- Створення скріншотів або знімків DOM під час взаємодії агента з користувацьким інтерфейсом.
- Ручні дослідницькі сесії, під час яких перевіряються граничні випадки, з якими модель може поводитися непередбачувано.
9. П’ять конкретних запитань, які тестувальник може поставити під час оцінки агента штучного інтелекту
- Які конкретні критерії успішності?
– Визначте вимірювані критерії (наприклад, «відповідь має містити принаймні одне фактичне твердження та не містити заборонених слів»).
- Як зберігається стан агента і чи можна його скинути між запусками?
– Переконайтеся, що тестові дані (історія запитів, профіль користувача) очищені, щоб один тест не впливав на наступний.
- Які побічні ефекти викликає цей агент і як їх можна виявити?
– Визначте виклики нижчого рівня (електронна пошта, записи в базу даних) та створіть запити до API або тестові дублікати для їх перевірки.
- Які типи збоїв передбачаються та як про них повідомляють клієнту?
– Переконайтеся, що відповіді на помилки (наприклад, 429 — обмеження швидкості, 400 — помилка валідації) є послідовними, а в інтерфейсі користувача відображається чітке повідомлення.
- Які можливості моніторингу надає цей сервіс для налагодження?
– Перевірте наявність ідентифікаторів запитів, журналів трасування або кінцевої точки «debug», яка повертає етапи міркування моделі.
Вчасне надання відповідей на ці питання допомагає сформувати план тестування, який забезпечує баланс між детермінованими перевірками API та дослідницьким характером поведінки агентів.
10. У яких випадках автоматизація допомагає
- Прискорення перевірки контрактів — один виклик API дозволяє перевірити контракт за лічені мілісекунди, що набагато швидше, ніж навігація через інтерфейс користувача.
- Зменшення нестабільності тестів, що перевіряють лише інтерфейс користувача – Завдяки підготовці даних через API тест інтерфейсу користувача більше не залежить від дій у інтерфейсі, які схильні до проблем із синхронізацією.
- Сумісність із безперервною інтеграцією — набори тестів, що використовують лише API, можуть виконуватися без будь-яких браузерних програм, що скорочує час виконання завдань безперервної інтеграції та споживання ресурсів.
- Захисна мережа від регресії — коли зміна в бекенді ненавмисно змінює формат відповіді, тест API негайно завершується з помилкою, запобігаючи ланцюговій реакції збоїв у роботі інтерфейсу користувача.
- Відстежувані дані — Playwright автоматично фіксує пари «запит/відповідь» у своєму протоколі тестування, надаючи розробникам єдиний артефакт, який відображає як дані API, так і кінцевий стан інтерфейсу користувача.
Автоматизація не замінює людське судження: вона не може визначити, чи є згенерована відповідь семантично правильною, а також не може оцінити, чи відповідає планування ШІ бізнес-правилам, які не викладені в HTTP-контракті. Саме в цих прогалинах дослідницьке тестування та експерти предметної області створюють додаткову цінність.
11. Висновок
Рішення APIRequestContext від Playwright дозволяє командам із забезпечення якості розглядати сервіси бекенду та кінцеві точки ШІ-агентів як повноправні елементи того самого набору тестів, що керує браузером. Завдяки розробці перевірок контрактів, послідовній автентифікації, явному управлінню станом та тестуванню негативних сценаріїв ви отримуєте швидкий, детермінований зворотний зв'язок щодо тих частин системи, які найкраще піддаються автоматизації.
Водночас обмеження перевірок, що базуються виключно на HTTP нагадують нам, що робочі процеси агентів часто передбачають недетерміноване генерування мови, забезпечення дотримання політик та приховані дерева рішень. Додаткові методи — журнали трасування, перевірка побічних ефектів та цільові дослідницькі сесії — є необхідними для того, щоб бути впевненими в тому, що ШІ поводиться відповідально в умовах реального середовища.
Коли ці два світи продумано поєднуються, Playwright перетворюється на єдину інтегровану платформу для забезпечення якості як інтерфейсу користувача, так і API, що дозволяє командам випускати функціональніші рішення з можливостями штучного інтелекту з надійною системою захисту.
Джерела
- Keploy – “Playwright API testing: A complete guide” (DEV Community). https://dev.to/keploy/playwright-api-testing-a-complete-guide-49f
- Playwright documentation – API testing overview. https://playwright.dev/docs/api-testing
- Playwright documentation –
APIRequestContextclass reference. https://playwright.dev/docs/api/class-apirequestcontext - Testheon – “Playwright API testing lets you call your application’s HTTP endpoints directly”. https://testheon.com/playwright-api-testing
- GetAutonoma – “Playwright API testing: A complete guide”. https://getautonoma.com/blog/playwright-api-testing-guide
- Techment – “Agentic AI testing with Playwright: 2026 QA guide”. https://www.techment.com/blogs/agentic-ai-testing-with-playwright

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