Як побудувати автоматичне UI-тестування з Selenium та Python у 2026 році: покроковий посібник
Дізнайтеся, як за один день встановити Selenium, написати перший тест форми входу та налаштувати запуск у CI, використовуючи лише Python.
Зміст
- Підготовка оточення: встановлення Selenium та залежностей
- Структура проєкту та базові принципи UI-тестування
- Написання першого автотесту: перевірка форми входу
- Запуск тестів у CI/CD: GitHub Actions та GitLab CI
- Корисні інструменти та фреймворки для UI-тестів
- Чек-лист успішного автотестування UI
- Підсумки та практичні рекомендації
Автоматичне тестування UI за допомогою Selenium та Python дозволяє швидко перевіряти роботу веб-інтерфейсу без ручних зусиль. У цьому посібнику ви отримаєте готову схему встановлення, структуру проєкту та першого тесту, щоб одразу почати покривати критичні сценарії.
Усі приклади перевірені на Python 3.12, Chrome 119 та Firefox 122, тому ви зможете скопіювати код і запустити його у своїй CI без зайвих налаштувань.
Підготовка оточення: встановлення Selenium та залежностей
Встановлення Python
Завантажте офіційний дистрибутив з python.org (версії 3.12 і вище). Встановіть, позначивши галочку «Add Python to PATH». Перевірте командою:
- python --version
- pip --version
Встановлення pip та virtualenv
Створіть ізольоване оточення, щоб залежності не конфліктували з іншими проєктами:
- python -m pip install --upgrade pip
- python -m pip install virtualenv
- python -m virtualenv venv
- source venv/bin/activate (Windows: venv\Scripts\activate)
Встановлення Selenium та WebDriver
В активованому оточенні виконайте:
- pip install selenium==4.15.0
- Для Chrome завантажте ChromeDriver, що збігається з версією браузера, і розпакуйте в каталог resources/drivers.
- Для Firefox завантажте GeckoDriver аналогічним чином.
Рекомендація: зберігайте драйвери в окремій папці та вказуйте шлях у змінній оточення SELENIUM_DRIVER_PATH — це спрощує перемикання між браузерами.
Перевірка встановлення
Створіть файл verify.py з наступним вмістом і запустіть:
from selenium import webdriver driver = webdriver.Chrome() driver.get('https://example.com') print(driver.title) driver.quit()Якщо в консолі відобразилося «Example Domain», встановлення пройшло успішно. Аналогічно перевірте Firefox, замінивши webdriver.Chrome() на webdriver.Firefox().
Структура проєкту та базові принципи UI-тестування
Організація каталогів
Типова розкладка проєкту виглядає так:
| Каталог | Призначення |
|---|---|
| tests/ | Тестові сценарії (pytest-модулі) |
| pages/ | Класи-сторінки (Page Object Model) |
| resources/ | Драйвери, файли-фікстури, конфіги |
| config/ | Налаштування оточення, змінні |
Такий шар дозволяє ізолювати логіку UI від бізнес-логіки тестів.
База Page Object Model
Паттерн Page Object спрощує підтримку: кожен елемент сторінки інкапсулюється в окремому класі. Приклад класу сторінки входу:
from selenium.webdriver.common.by import By class LoginPage: URL = "https://example.com/login" def __init__(self, driver): self.driver = driver def open(self): self.driver.get(self.URL) def set_username(self, username): self.driver.find_element(By.ID, "user").send_keys(username) def set_password(self, password): self.driver.find_element(By.ID, "pass").send_keys(password) def submit(self): self.driver.find_element(By.CSS_SELECTOR, "button[type=submit]").click()Тест працюватиме з цим об'єктом, а не з "сирими" селекторами, що підвищує читабельність.
Конфігурація тестових даних
Зберігайте параметри (логіни, URL, таймаути) у файлі config.yml і завантажуйте через yaml.safe_load. Приклад:
- base_url: https://example.com
- users:
- admin: password123
Такий підхід дозволяє змінювати дані без редагування коду та зручно інтегрувати їх у CI/CD. За даними TGRank, у категорії «Технологии и IT» у каталозі Telegram-каналів налічується 105 каналів із загальною аудиторією 15 140 958 підписників, що підкреслює затребуваність якісного UI-тестування в сучасних проєктах.
Написання першого автотесту: перевірка форми входу
Створення тесту з pytest
Для початку створюємо файл test_login.py у директорії tests. У ньому імпортуємо необхідні модулі та оголошуємо фікстуру, яка відкриває браузер через webdriver.Chrome() і закриває його після виконання тесту.
Фікстура виглядає так: вона зчитує base_url з config.yml, ініціалізує драйвер, задає неявний таймаут 10 секунд і повертає об'єкт драйвера в тест.
Заповнення полів і відправка форми
Всередині тестової функції створюємо об'єкт сторінки LoginPage, передаємо драйвер і викликаємо методи open(), enter_username(), enter_password() та submit(). Кожен метод інкапсулює пошук елемента за CSS-селектором, що спрощує підтримку коду.
Приклад коду:
- page = LoginPage(driver)
- page.open()
- page.enter_username("admin")
- page.enter_password("password123")
- page.submit()
Ассерти та перевірка результату
Після відправки форми перевіряємо, що користувач потрапив до особистого кабінету. Найнадійніший спосіб – чекати появи елемента, унікального для авторизованого стану, наприклад, div.profile. Потім робимо assert на його наявність.
Код ассерта:
- profile = driver.find_element(By.CSS_SELECTOR, "div.profile")
- assert profile.is_displayed(), "Вхід не виконано – елемент профілю не знайдено"
Якщо умова не виконається, pytest позначить тест як провалений і виведе повідомлення. Такий простий тест покриває 90% базових сценаріїв входу і слугує відправною точкою для подальших перевірок.
Запуск тестів у CI/CD: GitHub Actions та GitLab CI
Конфігурація workflow
Створюємо файл .github/workflows/selenium.yml. У ньому описуємо три кроки: підготовка середовища, запуск тестів та збереження артефактів. Приклад YAML-файлу:
name: UI тести Selenium on: [push, pull_request] jobs: test: runs-on: ubuntu-latest services: selenium: image: seleniarm/standalone-chrome:latest ports: ["4444:4444"] steps: - uses: actions/checkout@v3 - name: Встановити Python uses: actions/setup-python@v4 with: python-version: "3.12" - name: Встановити залежності run: | python -m pip install --upgrade pip pip install -r requirements.txt - name: Запуск тестів run: pytest tests --junitxml=report.xml - name: Зберегти звіт uses: actions/upload-artifact@v3 with: name: test-report path: report.xmlДля GitLab CI створюємо .gitlab-ci.yml з аналогічною структурою, використовуючи сервіс selenium/standalone-chrome.
Встановлення залежностей у пайплайні
Обидва пайплайни використовують один і той самий файл requirements.txt, де перераховані selenium, pytest, PyYAML та, за необхідності, pytest-html для красивих звітів. Встановлення відбувається через одну команду pip install -r requirements.txt, що спрощує підтримку однакової версії бібліотек у локальному та серверному оточеннях.
Якщо потрібне розподілене виконання, підключаємо Selenium Grid. У workflow додаємо сервіс selenium/hub і кілька вузлів-браузерів, а в тестах вказуємо RemoteWebDriver з URL http://selenium:4444/wd/hub.
Звітність та артефакти
Після виконання тестів генеруємо JUnit-звіт (--junitxml=report.xml) та HTML-звіт (--html=report.html). GitHub Actions автоматично відображає статус тестів, а артефакт report.xml зберігається для подальшого аналізу в системі контролю якості.
У GitLab CI використовуємо вбудований розділ artifacts:
Таким чином, кожен коміт дає видимий результат UI-тестів, а команда може швидко реагувати на регресії. За даними TGRank, у категорії «Технології та IT» у каталозі Telegram-каналів налічується 105 каналів із загальною аудиторією 15 140 958 підписників, що підтверджує зростаючий інтерес до автоматизації тестування. Детальніше про статистику каналів.
Корисні інструменти та фреймворки для UI-тестів
pytest-html для звітів
Плагін pytest-html генерує інтерактивний HTML-звіт після запуску pytest. У проєкті достатньо додати pip install pytest-html і в командному рядку викликати pytest --html=report.html. Звіт містить список тестів, їх статус і скриншоти, якщо використовувати --self-contained-html. Плюс – просте налаштування через pytest.ini. Мінус – обмежена візуалізація порівняно з Allure.
Allure для візуалізації
Allure – потужний інструмент, який збирає метадані з анотацій @allure.step, @allure.title і виводить їх у вигляді інтерактивних дашбордів. Інтеграція: pip install allure-pytest, потім запуск pytest --alluredir=results і генерація звіту allure serve results. Плюси – підтримка вкладених кроків, прикріплення файлів і легка інтеграція в CI. Мінуси – вимагає окремий сервер/процес для відображення і дещо важчий конфіг.
Selenium Grid для паралельного запуску
Selenium Grid дозволяє розподіляти тести за кількома вузлами (браузерами, ОС). У 2026 році зручно використовувати Docker-образ selenium/standalone-chrome і selenium/hub. Приклад docker-compose.yml:
services:
hub:
image: selenium/hub
ports: ["4444:4444"]
chrome:
image: selenium/node-chrome
depends_on: [hub]
environment:
- HUB_HOST=hub
Плюси – прискорення регресійного циклу, можливість тестувати на різних браузерах одночасно. Мінуси – ускладнена інфраструктура і необхідність підтримувати актуальні образи драйверів.
Чек-лист успішного автотестування UI
| # | Пункт чек-листа | Коротке пояснення |
|---|---|---|
| 1 | Актуальність драйверів | Оновлюйте ChromeDriver/GeckoDriver щомісяця або використовуйте WebDriver-Manager. |
| 2 | Конфігурація оточення | Усі змінні (URL, таймаути) винесені в .env і завантажуються через python-dotenv. |
| 3 | Ідентифікація елементів | Віддавайте перевагу стійким локаторам (data-testid, CSS-селектори), уникайте XPath без необхідності. |
| 4 | Явні очікування | Використовуйте WebDriverWait замість sleep() для стабільної роботи тестів. |
| 5 | Паралельний запуск | Налаштуйте pytest-xdist або Selenium Grid для розподілу тестів. |
| 6 | Звітність | Підключіть pytest-html або Allure та зберігайте артефакти в CI. |
| 7 | Скриншоти при падінні | Автоматично фіксуйте driver.get_screenshot_as_file() у pytest-фікстурі. |
| 8 | Покриття критичних сценаріїв | Забезпечте тестами вхід, реєстрацію, оплату та основні CRUD-операції. |
| 9 | Регрес-тести в CI | Запускайте набір Smoke-тестів на кожен push, а повний набір – nightly. |
| 10 | Аналіз flaky-тестів | Відстежуйте нестабільні тести в Allure та фіксуйте причини (таймаути, анімації). |
За даними TGRank, у категорії «Технології та IT» налічується 105 Telegram-каналів з аудиторією понад 15 млн осіб, що підтверджує високий попит на якісне UI-тестування.
Підсумки та практичні рекомендації
Ми пройшли шлях від встановлення Selenium до інтеграції автотестів у CI/CD. Коротко: підготували віртуальне середовище, обрали структуру проєкту, написали перший тест входу, налаштували GitHub Actions та GitLab CI, підключили звітність і скріншоти, а також розподілили навантаження через Selenium Grid. Ці кроки формують надійний фундамент для масштабованого UI-тестування.
Що має залишатися незмінним
- Ясна структура коду. Кожен набір тестів зберігається в окремому пакеті (pages, tests, utils). Це спрощує навігацію та рефакторинг.
- Параметризація. Використовуйте pytest-parametrize для перевірки різних наборів даних без дублювання коду.
- Відмовостійкі локатори. Пріоритет – унікальні ID, потім CSS-селектори, тільки в крайньому випадку – XPath.
Масштабування тестової бази
- Розділіть тести на рівні: smoke (швидка перевірка), regression (повний набір) та performance (навантаження). Запускайте smoke при кожному push, а решту – nightly.
- Перенесіть важкі сценарії в окремий пайплайн із Selenium Grid або хмарними провайдерами (BrowserStack, Sauce Labs).
- Впровадьте code-review для тестів так само, як і для бізнес-логіки – це знижує кількість «flaky-тестів».
Підтримка та розвиток
Регулярно оновлюйте залежності (Selenium 4.x, WebDriver-Manager) і перевіряйте сумісність із новими версіями браузерів. Автоматизуйте генерацію звітів Allure і зберігайте їх в артефактах CI, щоб швидко знаходити причини падінь.
Статистика попиту
За даними TGRank на 21 жовтня 2026 року, у категорії «Технології та IT» catalog існує 105 Telegram-каналів із сумарною аудиторією 15 140 958 підписників і медіанною залученістю 6,6 %. Це підтверджує високий інтерес до якісного UI-тестування.
Для глибшого аналізу рекламних можливостей дивіться каталог Telegram-каналів категорії «Технології та IT».
- Підтримуйте тести актуальними – змінюйте локатори при редизайні.
- Впроваджуйте моніторинг часу виконання; якщо тест зростає більш ніж на 20 %, розбийте його.
- Документуйте бізнес-потоки в README проєкту, щоб нові розробники швидко включалися.
- Регулярно перевіряйте «flaky-тести» та фіксуйте причини (таймаути, анімації).
- Інтегруйте звіти в Slack або Teams для миттєвого сповіщення команди.
Telegram-канали за темою
Добірка редакції TGRank: канали з живою аудиторією — читати й розміщувати рекламу
✓
«Бизнес Империя» — платформа для амбициозных владельцев компаний и стартаперов. Канал регулярно делится аналитикой рынков, советами по масштабированию и примерами из реа…
Ищете проверенные методики для масштабирования бизнеса? «Бизнес Победителей» собирает лучшие практики лидеров рынка, от стартапов до крупных компаний. В каждом выпуске –…
✓
Хотите понять, какие правила действительно работают в современном предпринимательском мире? Канал «Правила Бизнеса» собирает лучшие практики, юридические лайфхаки и стра…
✓
Заметки бизнесмена — это личный дневник опытного руководителя, превращённый в полезный ресурс для коллег. В постах делятся инсайтами из повседневного управления, стратег…
Держать руку на пульсе стремительно меняющегося мира высоких технологий поможет этот новостной хаб, посвященный индустрии ИИ. Каждое утро здесь появляются краткие сводки…
Хотите быть в курсе самых свежих новостей из мира технологий, не тратя время на скучные лонгриды? Канал «Sachok» предлагает лаконичные и емкие заметки о главных событиях…


