{"canonical_url":"https://engineer.company/uk/glossary/end-to-end-test/","content_markdown":"# Наскрізний тест\n\n## Що це таке\n\nНаскрізний тест перевіряє всю запущену систему так, як її бачить користувач. Він\nзапускає застосунок зі справжнім фронтендом, бекендом, базою даних і\nконфігурацією, проходить увесь шлях — скажімо, реєстрацію чи оплату замовлення —\nі наприкінці перевіряє те, що побачила б людина. Англійською це end-to-end test,\nкоротко E2E-тест, а саму практику називають наскрізним тестуванням.\n\nУ книжці _Software Engineering at Google_ Adam Bender розкладає тести за двома\nосями. Розмір стосується ресурсів: малі тести виконуються в одному процесі,\nсередні можуть використовувати кілька процесів на одній машині, а великі —\nохоплювати кілька машин. Обсяг показує, скільки коду\nтест зачіпає, і тести великого обсягу мають кілька назв, серед них\nфункціональні, наскрізні та системні тести. Joseph Graves у розділі книжки про\nбільші тести додає, що тести найбільшого обсягу зазвичай залучають кілька\nсправжніх залежностей і менше тестових дублерів.\n\nЦі справжні залежності дають достовірність: Graves визначає її як те, наскільки\nточно тест відображає справжню поведінку системи, яку він перевіряє. Модульний\nтест форми оформлення замовлення доводить, що код форми правильний в\nізольованому середовищі; наскрізний тест тієї самої форми доводить, що\nрозгорнута сторінка, маршрут за нею, правила ціноутворення й база даних\nузгоджуються між собою. Платити доводиться герметичністю: що більше середовище\nсхоже на продакшн, то важче відгородити його від усього іншого, і, за словами\nGraves, ці дві властивості часто прямо суперечать одна одній.\n\nДля вебзастосунку інтерфейсом користувача є браузер, тож саме там і стоїть\nнаскрізний тест. Graves каже про це прямо: для кінцевих користувачів «публічний\nAPI — це і є сам застосунок». Playwright Test, на якому побудовано приклад\nнижче, описує себе як фреймворк для наскрізного тестування сучасних\nвебзастосунків. У ньому зібрано запускач тестів, перевірки, ізоляцію та\nпаралельний запуск, і він керує Chromium, Firefox і WebKit — як із вікном\nбраузера, так і без нього.\n\n## Чому це важливо\n\nМенші тести лишають прогалини, які може закрити лише тест зібраної системи, і\nGraves перелічує найпоширеніші. Тестовий дублер може розійтися з тим, що він\nзамінює, і тест так і не дізнається, що справжня реалізація змінилася. Модульний\nтест покриває код усередині одного бінарника, а конфігурація розгортання,\nскрипти запуску й налаштування робочих екземплярів лишаються поза ним. Третя\nпрогалина — проблеми, що з'являються лише під навантаженням, а четверта —\nповедінка, якої ніхто не передбачив; саме так більшість проблем і доходить до\nкористувачів. Bender пише, що в Google великі тести здебільшого залишають для\nнаскрізних тестів усієї системи, які перевіряють радше конфігурацію, ніж окремі\nфрагменти коду.\n\nДо того ж вони перевіряють зібраний інтерфейс, із яким взаємодіє користувач.\nФорма, що надсилає дані на маршрут, який бекенд щойно перейменував, або реліз,\nчия конфігурація вказує не на той сервіс, проходять усі модульні тести з обох\nбоків — і ламаються, щойно ними спробує скористатися жива людина.\n\nЦіна — швидкість і надійність. Graves зазначає, що великі тести в Google мають\nтайм-аут за замовчуванням 15 хвилин або годину і що вони можуть бути\nнегерметичними, тобто ділити ресурси з іншими тестами й трафіком, а отже, бути\nнедетермінованими. Bender називає звичні джерела цієї недетермінованості:\nсистемний час, планування потоків, затримку мережі, а нижче — апаратні\nпереривання та рушії рендерингу браузерів. Тому книжка й пропонує як приблизне\nправило піраміду: близько 80% модульних тестів вузького обсягу, 15%\nінтеграційних і 5% наскрізних, що перевіряють усю систему. Більші тести, пише\nBender, слугують перевірками на здоровий глузд у міру розвитку продукту і не\nмають бути основним способом, яким команда ловить помилки; команди в Google\nчасто запускають їх лише під час збирання й випуску, щоб вони не гальмували\nщоденну розробку.\n\n## Як це виглядає на практиці\n\nВізьмімо інтернет-магазин, що продає чайник і запитує в API перевізника, скільки\nтриватиме доставка. Специфікація Playwright для першої покупки гостя читається\nяк сам цей шлях:\n\n```ts\n// e2e/checkout.spec.ts\nimport { test, expect } from \"@playwright/test\";\n\ntest.beforeEach(async ({ page }) =\u003e {\n    // API перевізника належить іншим: відповідаємо за нього тут.\n    await page.route(\"https://api.carrier.example/**\", (route) =\u003e\n        route.fulfill({ status: 200, body: '{\"days\": 2}' }),\n    );\n});\n\ntest(\"гість може купити чайник\", async ({ page }) =\u003e {\n    await page.goto(\"/shop/teapot\");\n    await page.getByRole(\"button\", { name: \"Додати в кошик\" }).click();\n    await page.getByRole(\"link\", { name: \"Кошик\" }).click();\n    await expect(page.getByText(\"Доставка за 2 дні\")).toBeVisible();\n    await page.getByLabel(\"Електронна пошта\").fill(\"buyer@example.com\");\n    await page.getByRole(\"button\", { name: \"Оформити замовлення\" }).click();\n    const thanks = page.getByRole(\"heading\", { name: \"Дякуємо за покупку\" });\n    await expect(thanks).toBeVisible();\n    await page.getByRole(\"link\", { name: \"Переглянути замовлення\" }).click();\n    await expect(page.getByText(\"Чайник\")).toBeVisible();\n});\n```\n\nКожен локатор називає те, що бачить користувач: кнопку «Додати в кошик», поле з\nпідписом «Електронна пошта», заголовок «Дякуємо за покупку». Playwright радить\nнасамперед локатори за роллю, а його локатори суворі: коли опису відповідає\nкілька елементів, дія кидає помилку, замість того щоб вгадувати. Перед кожним\nкліком чи заповненням поля Playwright чекає, доки елемент стане придатним до\nдії, а перевірка на кшталт `toBeVisible()` повторюється, доки умова не\nсправдиться, тож специфікація обходиться без пауз. Виклик `page.route`\nвідповідає на запити браузера до перевізника фіксованим тілом, і тест ніколи не\nзалежить від сервера, яким команда не керує; шаблон має охоплювати всю\nURL-адресу, а `**` проходить і крізь скісні риски. Маршрутизація перехоплює лише\nті запити, які надсилає сама сторінка: якщо перевізника питає сервер магазину,\nбраузер цього запиту не бачить, і тоді тестовий дублер має стояти на боці\nсервера. Кожен тест до того ж отримує свіжий контекст браузера, який Playwright\nпорівнює з абсолютно новим профілем браузера, тож кукі й кошик одного тесту не\nпросочуються в наступний.\n\nКонфігурація запускає застосунок і повідомляє Playwright, де його шукати:\n\n```ts\n// playwright.config.ts\nimport { defineConfig } from \"@playwright/test\";\n\nexport default defineConfig({\n    testDir: \"e2e\",\n    retries: process.env.CI ? 2 : 0,\n    use: {\n        baseURL: \"http://localhost:3000\",\n        trace: \"on-first-retry\",\n    },\n    webServer: {\n        command: \"npm run start\",\n        url: \"http://localhost:3000\",\n        reuseExistingServer: !process.env.CI,\n    },\n});\n```\n\nБлок `webServer` виконує `npm run start` і чекає, доки URL почне відповідати,\nа вже тоді запускає перший тест; на ноутбуці він бере сервер, який уже працює,\nа в CI завжди запускає власний. `baseURL` дає змогу писати в специфікації\n`/shop/teapot` замість повної адреси. Команда `npx playwright test` запускає\nнабір без вікна браузера, прапорець `--headed` показує вікно, а\n`npx playwright show-report` відкриває HTML-звіт. За замовчуванням Playwright не\nповторює тести, що впали; тут у CI дозволено два повтори, тест, який спершу\nвпав, а потім пройшов, позначається як нестабільний (flaky), а не як пройдений,\nа під час першого повтору записується трасування, яке показує, що пішло\nінакше.\n\nУ більшому масштабі браузерний рівень — найменша частина роботи.\n[Набір тестів для Go, SQL і браузера](/uk/portfolio/built-a-test-suite-across-go-sql-and-browser/)\n— робота 2025 року — налічує 981 тестову функцію на Go у 310 файлах, 543\nспецифікації Vitest і Playwright, зокрема 48 файлів наскрізних тестів і 30\nбраузерних специфікацій, а також 494 файли поведінкових тестів на SQL. Завдання\nполягало в тому, щоб перевіряти поведінку кожного рівня там, де вона справді\nживе, а не все ззовні через браузер, тож збережені функції перевіряють просто в\nбазі даних, без трьох рівнів застосунку зверху. Сторінка не приховує ціни: набір\nпрацює повільно, за нього платить кожна зміна, і за такого обсягу він сам\nпотребує супроводу.\n\n## Де виникають проблеми\n\n**Набір тестів — ріжок морозива.** Так Bender називає набір, у якому багато\nнаскрізних тестів і мало інтеграційних чи модульних; такі набори зазвичай\nповільні, ненадійні й незручні в роботі, а сама картина часто з'являється в\nпроєктах, які поспіхом перевели з прототипу в продакшн. Graves додає: коли код\nважко покрити модульними тестами, наскрізні тести — єдині, які взагалі вдається\nнаписати, і за лічені дні проєкт уже має легасі-код. Кожен новий сервіс до того\nж множить шляхи крізь систему, тож наскрізний набір ніколи не покриє їх усіх.\nОпускайте кожен випадок до найменшого тесту, який здатен його впіймати, лишайте\nбраузеру ті сценарії, які може показати лише вся система, і будуйте піраміду з\nперших днів проєкту.\n\n**Селектори прив'язані до розмітки.** Локатор на кшталт\n`button.buttonIcon.episode-actions-later` — власний приклад Playwright того,\nчого слід уникати, — ламається, щойно хтось перейменує клас, хоча для\nкористувача все виглядає так само. Graves попереджає, що UI-тести мають\nрепутацію ненадійних і дорогих, зокрема тому, що їх ламають зміни зовнішнього\nвигляду, тоді як поведінка лишається тією самою. Шукайте елементи за роллю,\nпідписом або текстом — так, як їх знаходить користувач, — або за тестовим\nідентифікатором, який належить команді. Якщо бекенд має публічний API, розріжте\nсценарій на межі між UI та API і проведіть решту наскрізного тесту через API.\n\n**Тест спить.** Фіксована пауза закоротка в повільний день і задовга в усі інші.\nGraves зазначає, що тести, які покладаються на паузи й тайм-аути, починають\nпадати всі разом, коли машини, на яких вони працюють, перевантажені, а повторні\nзапуски лише додають навантаження. Найкращі практики Playwright показують тонший\nваріант тієї самої помилки: `expect(await\npage.getByText(\"welcome\").isVisible()).toBe(true)` перевіряє один раз і йде\nдалі, а `await expect(page.getByText(\"welcome\")).toBeVisible()` чекає на умову.\nВикористовуйте web-first перевірки, а коли тест чекає на бекенд, опитуйте зміну\nстану з тайм-аутом.\n\n**Тести мають спільні дані.** Один тест створює обліковий запис, на який\nрозраховує наступний, або два паралельні воркери купують останній чайник на\nскладі. Набір проходить в одному порядку й падає в іншому або лише тоді, коли\nтести йдуть паралельно. Playwright радить повністю ізолювати кожен тест — із\nвласним сховищем, сесією, даними й кукі — і контролювати дані в будь-якій базі\nданих, з якою працюють тести. Створюйте все, що потрібно тесту, з унікальними\nназвами й ніколи не покладайтеся на те, що лишив попередній тест.\n\n**У тесті чужий сервер.** Справжній платіжний провайдер, перевізник чи\nкартографічний сервіс робить набір залежним від системи, якою команда не керує,\nа трафік до нього може коштувати грошей. Graves пише, що автоматичним тестам не\nрекомендують звертатися до справжнього стороннього API і що така залежність —\nважливий шов, по якому варто розділяти тести; сам Playwright радить тестувати\nлише те, що ви контролюєте. Відповідайте за третю сторону через `page.route`,\nколи запит надсилає браузер, як це робить специфікація вище, або через тестовий\nдублер, на який у конфігурації вказує сервер, коли запит надсилає він сам, і\nнехай саме ця залежність стане місцем, де тест закінчується.\n\n**Повтори приховують нестабільність.** Повтор у CI робить червону збірку\nзеленою, а витрати тим часом накопичуються. Bender проробляє арифметику: якщо\nщодня запускати 10 000 тестів і кожен має 0,1% імовірності хибного падіння,\nкоманда отримує 10 нестабільних падінь на день, які треба розслідувати, а коли\nнестабільність наближається до 1%, тести починають втрачати цінність. Повторний\nзапуск міняє машинний час на час інженерів і лише відкладає пошук справжньої\nпричини. Документація pytest каже те саме з іншого боку: тести вищого рівня\nчастіше бувають нестабільними, бо залежать від більшого обсягу стану. Вважайте\nкожен тест, який Playwright позначив як нестабільний, помилкою: відкривайте\nтрасування з повтору й виправляйте тест або видаляйте його.\n\n## Що почитати далі\n\n- [Testing Overview](https://abseil.io/resources/swe-book/html/ch11.html)\n  — розділ Adam Bender у _Software Engineering at Google_: розмір і обсяг\n  тестів, піраміда, ріжок морозива й ціна нестабільних тестів.\n- [Larger Testing](https://abseil.io/resources/swe-book/html/ch14.html)\n  — Joseph Graves про достовірність, прогалини, які лишають модульні тести,\n  межі UI та сторонніх сервісів і боротьбу з нестабільністю.\n- [Installation](https://playwright.dev/docs/intro)\n  — вступ від самого Playwright: встановлення Playwright Test, запуск\n  прикладу, режим із вікном браузера та HTML-звіт.\n- [Best Practices](https://playwright.dev/docs/best-practices)\n  — тестування видимої користувачеві поведінки, ізоляція тестів, сторонні\n  сервери поза тестами, локатори й web-first перевірки.\n- [Retries](https://playwright.dev/docs/test-retries)\n  — як Playwright повторює тести, що впали, і позначає кожен як passed, flaky\n  або failed.\n- [Flaky tests](https://docs.pytest.org/en/stable/explanation/flaky.html)\n  — пояснення pytest, чому тести бувають нестабільними, від неконтрольованого\n  стану системи й порядку тестів до потокобезпеки, і що з цим робити.\n\n\u003chttps://engineer.company/uk/glossary/end-to-end-test/\u003e\n","date_modified":"2026-11-12T05:34:23Z","description":"Місце наскрізного тесту поряд із модульними, розібраний приклад на Playwright із конфігурацією і звички, що роблять набір повільним і нестабільним.","formats":{"gemtext":"https://engineer.company/uk/glossary/end-to-end-test/index.gmi","gopher":"https://engineer.company/uk/glossary/end-to-end-test/gophermap","html":"https://engineer.company/uk/glossary/end-to-end-test/","json":"https://engineer.company/uk/glossary/end-to-end-test/index.json","markdown":"https://engineer.company/uk/glossary/end-to-end-test/index.md","pdf":"https://engineer.company/uk/glossary/end-to-end-test/index.pdf"},"kind":"page","language":"uk","title":"Що таке наскрізний тест?","url":"https://engineer.company/uk/glossary/end-to-end-test/","version":1}