Як команди із забезпечення якості можуть об’єднати перевірки контрактів, автентифікації, налаштування стану, негативних сценаріїв та побічних ефектів в єдиний набір тестів Playwright — і які існують обмеження, коли тестованою системою є ШІ-агент.


1. Чому варто об’єднати перевірки API та інтерфейсу користувача в одному запуску?

Сучасні додатки часто надають загальнодоступний HTTP-API, який забезпечує роботу як веб-інтерфейсу, так і набору сервісів на основі штучного інтелекту (чат-боти, системи рекомендацій, помічники з написання коду тощо). Коли інженер із забезпечення якості пише наскрізний тест (E2E) за допомогою Playwright, стандартний робочий процес полягає у запуску браузера, взаємодії з користувацьким інтерфейсом та перевірці відображеної сторінки.

Playwright також надає APIRequestContext — вбудований HTTP-клієнт, який може надсилати запити GET, POST, PUT, PATCH, DELETE та HEAD без відкриття браузера. Отже, цей самий засіб виконання тестів може:

У результаті отримуємо єдиний тестовий файл під контролем версій, який перевіряє весь стек, залишаючись при цьому швидким і детермінованим.


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. Налаштування та очищення стану — забезпечення детермінованості тестового середовища

Надійний набір тестів повинен ізолювати кожне виконання. Найпоширеніший підхід полягає в наступному:

  1. Налаштування — Використовуйте виклики API для створення саме тих даних, які знадобляться інтерфейсу користувача.
  2. Вправа — Виконайте кроки інтерфейсу користувача, які потрібно перевірити.
  3. Видалення — Видалити дані, створені на кроці 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

Отже, перевірки API слід доповнити наступним:


9. П’ять конкретних запитань, які тестувальник може поставити під час оцінки агента штучного інтелекту

  1. Які конкретні критерії успішності?

– Визначте вимірювані критерії (наприклад, «відповідь має містити принаймні одне фактичне твердження та не містити заборонених слів»).

  1. Як зберігається стан агента і чи можна його скинути між запусками?

– Переконайтеся, що тестові дані (історія запитів, профіль користувача) очищені, щоб один тест не впливав на наступний.

  1. Які побічні ефекти викликає цей агент і як їх можна виявити?

– Визначте виклики нижчого рівня (електронна пошта, записи в базу даних) та створіть запити до API або тестові дублікати для їх перевірки.

  1. Які типи збоїв передбачаються та як про них повідомляють клієнту?

– Переконайтеся, що відповіді на помилки (наприклад, 429 — обмеження швидкості, 400 — помилка валідації) є послідовними, а в інтерфейсі користувача відображається чітке повідомлення.

  1. Які можливості моніторингу надає цей сервіс для налагодження?

– Перевірте наявність ідентифікаторів запитів, журналів трасування або кінцевої точки «debug», яка повертає етапи міркування моделі.

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


10. У яких випадках автоматизація допомагає

Автоматизація не замінює людське судження: вона не може визначити, чи є згенерована відповідь семантично правильною, а також не може оцінити, чи відповідає планування ШІ бізнес-правилам, які не викладені в HTTP-контракті. Саме в цих прогалинах дослідницьке тестування та експерти предметної області створюють додаткову цінність.


11. Висновок

Рішення APIRequestContext від Playwright дозволяє командам із забезпечення якості розглядати сервіси бекенду та кінцеві точки ШІ-агентів як повноправні елементи того самого набору тестів, що керує браузером. Завдяки розробці перевірок контрактів, послідовній автентифікації, явному управлінню станом та тестуванню негативних сценаріїв ви отримуєте швидкий, детермінований зворотний зв'язок щодо тих частин системи, які найкраще піддаються автоматизації.

Водночас обмеження перевірок, що базуються виключно на HTTP нагадують нам, що робочі процеси агентів часто передбачають недетерміноване генерування мови, забезпечення дотримання політик та приховані дерева рішень. Додаткові методи — журнали трасування, перевірка побічних ефектів та цільові дослідницькі сесії — є необхідними для того, щоб бути впевненими в тому, що ШІ поводиться відповідально в умовах реального середовища.

Коли ці два світи продумано поєднуються, Playwright перетворюється на єдину інтегровану платформу для забезпечення якості як інтерфейсу користувача, так і API, що дозволяє командам випускати функціональніші рішення з можливостями штучного інтелекту з надійною системою захисту.


Джерела