Керівництво, орієнтоване на ризики, для QA‑інженерів, які повинні замінити встановлений набір Selenium на Playwright, зберігаючи видимість та аудиторську перевірку поведінкового покриття.


1. Почніть з інвентаризації та базової лінії

Перш ніж змінювати код, зафіксуйте те, що ви тестуєте. Конкретний інвентар зменшує ризик «тихої» втрати покриття.

Експортуйте цей інвентар у спільну таблицю або легку markdown‑таблицю, яку може редагувати вся команда. Розглядайте це як визначення покриття для проєкту міграції.


2. Створити реєстр паритету

Реєстр паритету — це живий документ, який зіставляє кожен сценарій Selenium з його аналогом у Playwright та фіксує статус еквівалентності.

Як користуватися журналом

  1. Створіть запис щойно тест Playwright підготовлено.
  2. Позначте “Очікувані відмінності” для будь‑якої навмисної зміни (наприклад, використовуючи expect(page).toHaveURL(url) Playwright замість assertEquals(url, expectedUrl) Selenium).
  3. Зберіть докази – вбудоване трасування Playwright (trace.zip) або скріншоти додаються до запису журналу.
  4. Встановіть статус відкату – ✅ 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

Ключові моменти

Важливо: 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'] } },
  ],
});

Ключові висновки


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: true

Workflow використовує офіційну матрицю GitHub Actions для окремого запуску налаштованих проєктів Playwright; публікує звіти та трасування як артефакти workflow, коли команді потрібні збережені докази.


7. Паралельний запуск старих та нових наборів

Щоб довести, що покриття не змінилося, запустіть обидва набори на одному коміті:

  1. Запустити набір Selenium → згенерувати JUnit XML, скріншоти та звіт про помилки.
  2. Запустити набір Playwright → згенерувати ті ж артефакти (Playwright може виводити JUnit XML через --reporter=junit).
  3. Порівняти зіставлені бізнес‑наміри та очікувані результати автоматично. Розглядайте різниці у успішних і невдалих результатах як сигнали для розслідування, а не як доказ еквівалентності, оскільки час, дані або середовище можуть відрізнятися між запусками.

Якщо з’являється розбіжність, позначте відповідний запис журналу паритету для розслідування перед продовженням.


8. Класифікація дельт та допустимий рівень flaky-тестів

Коли з’являються різниці, класифікуйте їх:

Визначте допустимий рівень flaky-тестів, яким керує команда, виходячи з поточної базової лінії, і відстежуйте його в реєстрі. Повторні спроби Playwright можуть допомогти класифікувати тест як нестабільний, але їх не слід використовувати для приховування нестабільності; як помилка під час першого запуску, так і результат повторної спроби мають залишатися видимими.


9. Критерії поетапного переходу та відкату

Міграція, орієнтована на мінімізацію ризиків, здійснюється етапами:

Відкат означає повторне ввімкнення збереженого Selenium CI завдання через переглянуту зміну конфігурації, тоді як реалізація Playwright залишається доступною для діагностики та виправлення.


10. Перелік перевірки міграції QA


11. Де автоматизація допомагає

Автоматизація не замінює людське судження щодо того, що є бізнес‑правильним; вона лише робить докази міграції відтворюваними та аудиторськими.


12. Висновок

Міграція усталеного набору тестів Selenium до Playwright – це не просте копіювання та вставлення. Шляхом інвентаризації існуючого покриття, створення реєстру відповідності та одночасного запуску обох наборів, команди можуть кількісно оцінити ризик і продемонструвати, що не з’явилися непояснені прогалини у поведінці. Авто‑очікування Playwright, надійне трасування та вбудовані фікстури спрощують підтримку тестів, проте їх треба доповнювати явними асерціями, що відображають справжній бізнес‑намір. Поетапний перехід, чіткі критерії відкату та дисциплінований допустимий рівень flaky-тестів тримають міграцію під контролем. При виконанні цього ризик‑орієнтованого підходу перехід залишає ризики видимими і надає рецензентам відтворювані докази для рішення, коли кожна критичний сценарій готовий до переходу.


Запитання для самоперевірки

  1. Яку трійку інформації слід зафіксувати для кожного тесту Selenium перед міграцією?
  2. Чим авто‑очікування Playwright відрізняється від явного WebDriverWait Selenium, і чому асерції все одно мають бути явними?
  3. Яка мета реєстр відповідності і які поля є необхідними для аудиторської прозорості?
  4. Опишіть один конкретний спосіб використання функції трасування Playwright у процесі міграції.
  5. Назвіть два критерії, які спровокують відкат під час поетапного переходу.

Джерела