Руководство, основанное на рисках, для QA‑инженеров, которым нужно заменить устоявшийся набор тестов Selenium на Playwright, сохранив при этом видимость и проверяемость покрытия поведения системы.


1. Начните с инвентаризации и базового уровня

Прежде чем любой код будет перемещен, зафиксируйте то, что вы тестируете. Конкретный инвентарь снижает вероятность незаметной потери покрытия.

Экспортируйте этот инвентарь в общую таблицу или лёгкую таблицу разметки, которую может редактировать вся команда. Воспринимайте это как определение покрытия для проекта миграции.


2. Создайте реестр соответствия

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

Как пользоваться реестром соответствия

  1. Создайте запись сразу после того, как будет составлен тест Playwright.
  2. Отмечайте «Ожидаемые различия» при любых намеренных изменениях (например, использование expect(page).toHaveURL(url) Playwright вместо assertEquals(url, expectedUrl) Selenium).
  3. Соберите доказательства – Встроенная трассировка (trace.zip) или скриншоты Playwright прикреплены к записи в реестре.
  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

Ключевые моменты

Важно: Автоматическое ожидание не гарантирует, что состояние интерфейса соответствует бизнес-правилу. Сохраняйте явные проверки, кодирующие ожидаемый результат (например, «появляется номер подтверждения заказа»).

Ссылки: Документация Playwrightов по auto-waiting и locators.


4. Сохраняйте абстракции страниц/компонентов

Если ваш пакет Selenium уже использует Page Object Model (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 по объектам страницы и сохраняет видимость намерения верификации; Объекты страницы 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. Краткий фрагмент рабочего процесса:

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

Рабочий процесс использует официальную матрицу действий GitHub для отдельного запуска настроенных проектов Playwright; публикация отчётов и трассировок в виде артефактов рабочего процесса, когда команде нужны сохранённые доказательства.


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

Чтобы доказать, что покрытие не изменилось, запустите обе пакеты на одном комите:

  1. Запустить Selenium suite → сгенерировать JUnit XML, скриншоты и отчёт о сбоях.
  2. Выполнить набор Playwright → генерировать одни и те же артефакты (Playwright может выводить JUnit XML через --reporter=junit).
  3. Автоматически сравнить отображённые бизнес-намерения и ожидаемый результат. Рассматривайте различия в прохождении/несостоянии как сигналы расследования, а не как доказательство эквивалентности, поскольку время, данные или среда могут различаться между запусками.

Если обнаружено несоответствие, перед продолжением отметьте соответствующую запись в реестре чётности для проверки.


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

Когда различия проявляются, классифицируйте их:

Определите командный бюджет по текущей базового уровня и отслеживайте его в реестре. Повторные попытки Playwrightов могут помочь классифицировать тест как нестабильный, но повторные попытки не должны использоваться для скрытия нестабильности; провал первого забора и результат повтора должны оставаться видимыми.


9. Поэтапный переход и критерии отката

Избегающая риска миграция проходит поэтапно:

Откат означает повторное включение сохраненной задачи Selenium CI через пересмотренное изменение конфигурации, в то время как реализация Playwright остаётся доступной для диагностики и корректировки.


10. Чек‑лист QA при миграции


11. Где автоматизация помогает

Автоматизация не заменяет человеческое суждение о том, что считается деловой корректностью; она лишь делает данные миграции воспроизводимыми и подлежащими аудиту.


12. Заключение

Миграция устоявшегося набора тестов Selenium на Playwright — это не простое копирование и вставка. Путём инвентаризации существующего покрытия, создания реестра паритета и работы обоих пакетов бок о бок команды могут количественно оценить риск и показать, что не обнаружено необъяснённых пробелов в поведении. Автоматическое ожидание, надёжная трассировка и встроенные фикстуры Playwright упрощают поддержание тестирования, но их необходимо дополнять явными проверкими, отражающими фактические бизнес-требования. Поэтапный переход, чёткие критерии отката и дисциплинированный флейк-бюджет поддерживают миграцию под контролем. При реализации этого подхода, основанного на рисках, переход сохраняет видимость миграционного риска и даёт рецензентам воспроизводимые доказательства для принятия решения, когда каждый критический путь готов к переходу.


Вопросы для самопроверки

  1. Какие три элемента информации следует фиксировать для каждого теста на Selenium до миграции?
  2. Чем автоожидание Playwright отличается от явного WebDriverWait Selenium, и почему проверки всё равно должны быть явными?
  3. Какова цель реестра паритета и какие поля необходимы для аудитируемости?
  4. Опишите один конкретный способ использования функции трассировки Playwright в процессе миграции.
  5. Перечислите два критерия, которые могут вызвать откат во время поэтапного перехода.

Источники