Керівництво, орієнтоване на ризики, для QA‑інженерів, які повинні замінити встановлений набір Selenium на Playwright, зберігаючи видимість та аудиторську перевірку поведінкового покриття.
1. Почніть з інвентаризації та базової лінії
Перш ніж змінювати код, зафіксуйте те, що ви тестуєте. Конкретний інвентар зменшує ризик «тихої» втрати покриття.
- Категорія: Критичні користувацькі сценарії Що записувати: Наскрізні потоки (наприклад, «checkout», «реєстрація користувача») Чому це важливо: Визначає критичні шляхи користувачів, покриття яких має бути збережено та повторно перевірено.
- Категорія: Матриця браузерів Що записувати: Браузерні рушії, брендові канали, операційні системи та версії, які наразі покриває Selenium Чому це важливо:
PlaywrightпідтримуєChromium,FirefoxтаWebKit, а також вибрані брендові каналиChromium; явно перевірте потрібну матрицю, оскількиWebKitне ідентичнийSafari, і покриття движка не забезпечує автоматичну паритетність версій браузерів. - Категорія: Твердження Що записувати: Типи (видимість, текст, HTTP‑статус, стан БД) та місця (Page Objects, тіла тестів) Чому це важливо: Зробить намір верифікації видимим, щоб у новому наборі можна було створити еквівалентні докази.
- Категорія: Тестові дані та налаштування Що записувати: Фікстури, API‑заповнення, специфічні для тесту облікові записи Чому це важливо: Забезпечує відтворення тих самих передумов у Playwright.
- Категорія: Побічні ефекти Що записувати: Файли cookie, localStorage, зміни стану сервера Чому це важливо: Запобігає зникненню прихованих залежностей.
- Категорія: Історичні збої Що записувати: Нестабільні патерни, відомі баги, рівень відмов на тест Чому це важливо: Надає «бюджет нестабільності», який можна передати до нового набору.
- Категорія: Таймінг та очікування Що записувати: Явні
Thread.sleep,WebDriverWait, кастомні повтори Чому це важливо: Виділяє місця, де авто‑очікування Playwright може замінити крихкий код. - Категорія: Артефакти доказів Що записувати: Скріншоти, логи, JUnit XML, CI‑звіти Чому це важливо: Базові артефакти потрібні для подальшого порівняння.
Експортуйте цей інвентар у спільну таблицю або легку markdown‑таблицю, яку може редагувати вся команда. Розглядайте це як визначення покриття для проєкту міграції.
2. Створити реєстр паритету
Реєстр паритету — це живий документ, який зіставляє кожен сценарій Selenium з його аналогом у Playwright та фіксує статус еквівалентності.
- ID тесту Selenium:
S-Login-001ID тесту Playwright:PW-Login-001Бізнес-мета: Перевірте успішний вхід з дійсними обліковими даними Очікувані відмінності: Playwright використовує перевірки придатності локатора; Selenium використовував явне очікування Власник: Власник QA Докази (трасування, скріншот): Трасування Playwright + результат асерції Статус відкату: ✅ Готово - ID тесту Selenium:
S-Search-045ID тесту Playwright:PW-Search-045Бізнес-мета: Пошук повертає принаймні один результат Очікувані відмінності: Асерція переміщена з об’єкта сторінки в тіло тесту Власник: Власник QA Докази (трасування, скріншот): Скріншот + результат JUnit Статус відкату: ⏳ Очікує
Як користуватися журналом
- Створіть запис щойно тест Playwright підготовлено.
- Позначте “Очікувані відмінності” для будь‑якої навмисної зміни (наприклад, використовуючи
expect(page).toHaveURL(url)Playwright замістьassertEquals(url, expectedUrl)Selenium). - Зберіть докази – вбудоване трасування Playwright (
trace.zip) або скріншоти додаються до запису журналу. - Встановіть статус відкату –
✅ Readyколи новий тест запущено паралельно зі старим і результати відповідають базовому рівню; інакше залиште⏳ Pending.
Реєстр — це журнал аудиту зібраних доказів; він підтримує рішення про покриття, але сам по собі не може довести, що жодна поведінка не була пропущена.
3. Замініть явні очікування — використовуйте перевірки готовності елемента й автоматичні повтори Playwright
Тести Selenium часто містять такі шаблони:
new WebDriverWait(driver, Duration.ofSeconds(10))
.until(ExpectedConditions.elementToBeClickable(By.id("submit")));
driver.findElement(By.id("submit")).click();Філософія Playwright — “автоматично чекати правильну річ”. Еквівалент у TypeScript:
await page.getByRole('button', { name: 'Submit' }).click(); // waits for the locator to satisfy actionability checksКлючові моменти
- Шаблон Selenium:
Thread.sleep(3000)Заміна Playwright: Уникати; покладайтеся на дії локаторів, web-first перевірки або конкретну спостережувану умову. ЗберігайтеwaitForTimeoutлише для тимчасового налагодження, а не для продакшн‑тестів. Примітка про ризик: Фіксована пауза приховує реальну нестабільність. - Шаблон Selenium:
WebDriverWait+ExpectedConditionsЗаміна Playwright: Пряма взаємодія (click,fill,selectOption) абоawait expect(locator).toBeVisible()Примітка про ризик: Автоматично повторювана перевірка підтверджує видимість, а не бізнес‑правильність. - Шаблон Selenium: Користувацькі цикли повтору Заміна Playwright: Видалити; Playwright вже повторює дії, доки вони не стануть виконуваними (див. кращі практики Playwright) Примітка про ризик: Занадто часті повтори можуть приховати реальні дефекти.
Важливо: Auto‑waiting не гарантує, що стан UI відповідає бізнес‑правилу. Зберігайте явні перевірки, які кодують очікуваний результат (наприклад, “з’являється номер підтвердження замовлення”).
Посилання: документація Playwright про auto-waiting та locators.
4. Зберігайте абстракції сторінок / компонентів
Якщо ваш набір тестів Selenium вже використовує модель Page Object (POM), ви можете перенести структуру, перемістивши реалізацію до Playwright.
// src/pages/LoginPage.ts
import { Locator, Page } from '@playwright/test';
export class LoginPage {
readonly page: Page;
readonly username: Locator;
readonly password: Locator;
readonly submitBtn: Locator;
constructor(page: Page) {
this.page = page;
this.username = page.getByLabel('Username');
this.password = page.getByLabel('Password');
this.submitBtn = page.getByRole('button', { name: 'Login' });
}
async login(user: string, pass: string) {
await this.username.fill(user);
await this.password.fill(pass);
await this.submitBtn.click();
}
}Тримайте бізнес‑утвердження у файлах тестів замість того, щоб розміщувати їх у об’єктах сторінок. Це відповідає задокументованим рекомендаціям Selenium щодо Page Object і робить намір верифікації видимим; об’єкти сторінок Playwright все ще можуть інкапсулювати локатори та операції, орієнтовані на користувача.
5. Ізоляція фікстур і контекстів браузера
Тест‑раннер Playwright (@playwright/test) надає вбудовані фікстури для браузера, контексту та ізоляції сторінки. Мінімальний playwright.config.ts, який визначає ізольовані тести та три проєкти браузерних движків, може виглядати так:
import { defineConfig, devices } from '@playwright/test';
export default defineConfig({
testDir: './tests',
timeout: 30_000,
expect: { timeout: 5_000 },
fullyParallel: true,
повторні спроби: process.env.CI ? 2 : 0,
reporter: [['list'], ['html']],
use: {
headless: true,
viewport: { width: 1280, height: 720 },
ignoreHTTPSErrors: true,
trace: 'on-first-retry',
},
projects: [
{ name: 'chromium', use: { ...devices['Desktop Chrome'] } },
{ name: 'firefox', use: { ...devices['Desktop Firefox'] } },
{ name: 'webkit', use: { ...devices['Desktop Safari'] } },
],
});Ключові висновки
- Кожен тест отримує новий контекст браузера, що запобігає витоку стану між тестами (куки, сховище).
- Опція
traceзаписує повне трасування виконання при першій повторній спробі, що цінно для журналу паритету. - Паралельне виконання (
fullyParallel) може скоротити час CI, проте конкуренція ресурсів і ізоляція тестових даних мають вимірюватися у цільовому середовищі.
6. Крос‑браузерні проєкти та інтеграція CI
GitHub Actions може запускати три проєкти Playwright паралельно, подібно до Selenium Grid. Короткий фрагмент workflow:
name: Playwright Tests
on: [push, pull_request]
jobs:
e2e:
runs-on: ubuntu-latest
strategy:
matrix:
browser: [chromium, firefox, webkit]
steps:
- uses: actions/checkout@v4
- name: Set up Node
uses: actions/setup-node@v4
with:
node-version: '20'
- run: npm ci
- run: npx playwright install --with-deps ${{ matrix.browser }}
- run: npx playwright test --project=${{ matrix.browser }}
env:
CI: trueWorkflow використовує офіційну матрицю GitHub Actions для окремого запуску налаштованих проєктів Playwright; публікує звіти та трасування як артефакти workflow, коли команді потрібні збережені докази.
7. Паралельний запуск старих та нових наборів
Щоб довести, що покриття не змінилося, запустіть обидва набори на одному коміті:
- Запустити набір Selenium → згенерувати JUnit XML, скріншоти та звіт про помилки.
- Запустити набір Playwright → згенерувати ті ж артефакти (Playwright може виводити JUnit XML через
--reporter=junit). - Порівняти зіставлені бізнес‑наміри та очікувані результати автоматично. Розглядайте різниці у успішних і невдалих результатах як сигнали для розслідування, а не як доказ еквівалентності, оскільки час, дані або середовище можуть відрізнятися між запусками.
Якщо з’являється розбіжність, позначте відповідний запис журналу паритету для розслідування перед продовженням.
8. Класифікація дельт та допустимий рівень flaky-тестів
Коли з’являються різниці, класифікуйте їх:
- Категорія: Справжня регресія Опис: Змінена поведінка бізнесу (наприклад, відсутній елемент) Дія: Виправте застосунок або оновіть намір тесту.
- Категорія: Очікувана різниця в реалізації Опис: Інструменти синхронізуються по‑різному, хоча перевірений бізнес‑результат однаковий Дія: Запишіть причину та збережіть явні бізнес‑утвердження.
- Категорія: Флейк Опис: Перебої, що виникають випадково, не відтворюються в іншому наборі Дія: Додайте до бюджету нестабільних тестів; розгляньте налаштування повторних спроб або роботу зі стабілізації.
Визначте допустимий рівень flaky-тестів, яким керує команда, виходячи з поточної базової лінії, і відстежуйте його в реєстрі. Повторні спроби Playwright можуть допомогти класифікувати тест як нестабільний, але їх не слід використовувати для приховування нестабільності; як помилка під час першого запуску, так і результат повторної спроби мають залишатися видимими.
9. Критерії поетапного переходу та відкату
Міграція, орієнтована на мінімізацію ризиків, здійснюється етапами:
- Етап: Пілот Мета: Перенесіть невеликий набір критичних шляхів Метрика успіху: Необхідні записи в реєстрі:
✅ Ready, а різниці пояснено Тригер відкату: Будь-яка необґрунтована невідповідність у критичному шляху - Етап: Розгорнути Мета: Додати середньо-ризикові шляхи у контрольованих пакетах Метрика успіху: Узгоджений допустимий рівень flaky-тестів та критерії збереження доказів виконані Тригер відкату: Регресія або нестабільність перевищують базовий рівень команди
- Етап: Повний перехід Мета: Вивести Selenium‑завдання з експлуатації лише після узгодженого вікна спостереження Метрика успіху: Усі записи журналу в межах області готові, і відкат був відпрацьований Тригер відкату: Виявлена критична регресія або відсутність покриття
Відкат означає повторне ввімкнення збереженого Selenium CI завдання через переглянуту зміну конфігурації, тоді як реалізація Playwright залишається доступною для діагностики та виправлення.
10. Перелік перевірки міграції QA
- ✅ Пункт: Інвентаризація зафіксована Опис: Бізнес‑шляхи, браузери, асерції, дані, побічні ефекти, історичні помилки.
- ✅ Пункт: Створено журнал паритету Опис: Кожен тест Selenium зіставлений з тестом Playwright, з вказанням власника та доказів.
- ✅ Пункт: Локатори переглянуті Опис: Використовуйте рольові та текстові локатори Playwright; у міру можливості уникайте крихких CSS/XPath.
- ✅ Пункт: Явні очікування видалені Опис: Замінено на автоматичне очікування або цілеспрямовані перевірки
expect. - ✅ Пункт: Твердження збережені у тестах Опис: Перевірка на рівні бізнесу залишається поза об’єктами сторінок.
- ✅ Пункт: Фікстури визначені Опис: Налаштовано ізоляцію браузера, контексту та сторінки.
- ✅ Пункт: Додано крос‑браузерні проєкти Опис: Chromium, Firefox, WebKit визначені у
playwright.config.ts. - ✅ Пункт: Збір трасувань увімкнено Опис:
trace: 'on-first-retry'для доказів. - ✅ Пункт: CI-конвеєр для паралельного запуску двох наборів Опис: Набори Selenium і Playwright виконуються для кожного PR.
- ✅ Пункт: Процес класифікації дельти Опис: Документовано справжню регресію, очікувану різницю реалізації та обробку нестабільних тестів.
- ✅ Пункт: Допустимий рівень flaky-тестів погоджено Опис: Визначено командою від базової лінії та моніториться без приховування помилок першого запуску.
- ✅ Пункт: Поетапний план переходу Опис: Пілот, розширення, повний перехід з критеріями відкату.
- ✅ Пункт: Документація оновлена Опис: Керівні принципи дизайну тестів відображають кращі практики Playwright.
11. Де автоматизація допомагає
- Область: Базове генерування Перевага автоматизації: Тести Selenium можна скриптувати для створення базових скріншотів, логів та результатів JUnit для подальшого порівняння.
- Область: Порівняння реєстру відповідності Перевага автоматизації: Невеликий скрипт Node може порівнювати XML JUnit з обох наборів і автоматично позначати невідповідності.
- Область: Аналіз нестабільності Перевага автоматизації: Playwright Trace Viewer показує часову шкалу дій, знімки DOM, мережеву активність та вкладення, які допомагають діагностувати випадкові помилки.
- Область: Кросбраузерна звітність Перевага автоматизації: Матриця GitHub Actions генерує звіти по кожному браузеру без ручного налаштування.
- Область: Перевірка відкату Перевага автоматизації: Переглянутий прапорець CI або збережене завдання робить можливим тестування відкату без передчасного видалення будь‑якого набору.
Автоматизація не замінює людське судження щодо того, що є бізнес‑правильним; вона лише робить докази міграції відтворюваними та аудиторськими.
12. Висновок
Міграція усталеного набору тестів Selenium до Playwright – це не просте копіювання та вставлення. Шляхом інвентаризації існуючого покриття, створення реєстру відповідності та одночасного запуску обох наборів, команди можуть кількісно оцінити ризик і продемонструвати, що не з’явилися непояснені прогалини у поведінці. Авто‑очікування Playwright, надійне трасування та вбудовані фікстури спрощують підтримку тестів, проте їх треба доповнювати явними асерціями, що відображають справжній бізнес‑намір. Поетапний перехід, чіткі критерії відкату та дисциплінований допустимий рівень flaky-тестів тримають міграцію під контролем. При виконанні цього ризик‑орієнтованого підходу перехід залишає ризики видимими і надає рецензентам відтворювані докази для рішення, коли кожна критичний сценарій готовий до переходу.
Запитання для самоперевірки
- Яку трійку інформації слід зафіксувати для кожного тесту Selenium перед міграцією?
- Чим авто‑очікування Playwright відрізняється від явного
WebDriverWaitSelenium, і чому асерції все одно мають бути явними? - Яка мета реєстр відповідності і які поля є необхідними для аудиторської прозорості?
- Опишіть один конкретний спосіб використання функції трасування Playwright у процесі міграції.
- Назвіть два критерії, які спровокують відкат під час поетапного переходу.
Джерела
- Playwright documentation – Locators, Auto‑waiting, Tracing, Best Practices: https://playwright.dev/docs/locators
- Playwright documentation – Configuration and Projects: https://playwright.dev/docs/test-configuration
- Selenium documentation – WebDriverWait and ExpectedConditions: https://www.selenium.dev/documentation/webdriver/waits/
- GitHub Actions documentation – Matrix builds and workflow syntax: https://docs.github.com/en/actions/using-jobs/using-a-matrix-for-your-workflow
Залишити коментар
Поділіться думкою про статтю. Реєстрація не потрібна.
Коментарі
Завантаження коментарів…