Миграция с Selenium WebDriver

WebdriverIO является современным инструментом для автоматизированного тестирования веб-приложений, который предлагает более высокоуровневый и удобный API по сравнению с Selenium WebDriver. Миграция с Selenium на WebdriverIO часто становится актуальной, когда требуется улучшить производительность тестов, упростить процесс написания и поддержания тестов, а также воспользоваться более широкими возможностями интеграции с современными инструментами разработки. В этой статье рассмотрим процесс миграции с Selenium WebDriver на WebdriverIO, особенности, с которыми можно столкнуться, и как минимизировать возможные трудности.

1. Различия в архитектуре и подходах

API WebdriverIO vs. API Selenium

Одним из ключевых отличий WebdriverIO от Selenium является подход к построению API. Selenium WebDriver использует более низкоуровневый интерфейс для взаимодействия с браузером, в то время как WebdriverIO построен как обертка для Selenium, но с более простым и удобным API, поддерживающим асинхронные операции. WebdriverIO использует Promises и async/await для работы с асинхронным кодом, что делает код более читаемым и поддерживаемым.

В Selenium для ожидания действий приходится вручную обрабатывать асинхронные операции и использовать явные ожидания через WebDriverWait, тогда как в WebdriverIO большинство операций уже обрабатываются через стандартные команды с ожиданием завершения перед выполнением следующего шага.

Пример: Навигация по странице

В Selenium WebDriver код для навигации может выглядеть так:

WebDriver driver = new ChromeDriver();
driver.get("http://example.com");
WebElement element = driver.findElement(By.id("example"));
element.click();

В WebdriverIO это будет намного проще:

await browser.url('http://example.com');
const element = await $('#example');
await element.click();

Обратите внимание на использование async/await и сокращение количества кода в WebdriverIO. Это делает его удобнее для быстрого написания и тестирования.

2. Установка WebdriverIO

Миграция с Selenium на WebdriverIO начинается с установки и настройки самого WebdriverIO. Процесс достаточно прост и включает несколько шагов.

  1. Установить WebdriverIO и необходимые библиотеки через npm:
npm install --save-dev @wdio/cli
  1. Запустить процесс настройки через команду:
npx wdio config

Этот процесс предложит выбрать параметры конфигурации, такие как движок тестирования (например, Mocha), драйверы браузеров и другие параметры.

  1. Установить драйверы для браузеров:

Для работы с браузерами необходимо установить соответствующие драйверы. Например, для Chrome:

npm install --save-dev wdio-chromedriver-service

WebdriverIO поддерживает автоматическую установку драйверов, что значительно упрощает настройку.

3. Сравнение команды и локаторов

Локаторы

В Selenium WebDriver локаторы обычно задаются через различные стратегии поиска элементов, такие как By.id, By.className, By.xpath, и другие. В WebdriverIO локаторы задаются через функции, например:

const element = await $('#elementId');

Подобный синтаксис является более интуитивно понятным и позволяет работать с элементами гораздо быстрее.

Команды для взаимодействия с элементами

В WebdriverIO не нужно вручную искать элемент через отдельный метод, как это делает Selenium. Весь процесс поиска и взаимодействия с элементами осуществляется через цепочку команд. Например, чтобы кликнуть по элементу:

В Selenium:

WebElement element = driver.findElement(By.id("elementId"));
element.click();

В WebdriverIO:

await $('#elementId').click();

Эта особенность WebdriverIO позволяет упростить работу с элементами и уменьшить количество строк кода.

4. Асинхронность и ожидания

Одной из главных причин для миграции на WebdriverIO является улучшенная поддержка асинхронных операций. В Selenium часто приходится использовать различные ожидания, такие как WebDriverWait для явных ожиданий, чтобы дождаться появления элементов на странице.

В WebdriverIO синхронный код с использованием async/await позволяет автоматически ждать завершения операций:

await $('#elementId').click();

WebdriverIO сам заботится о времени ожидания и синхронизации, что упрощает написание тестов.

Для явных ожиданий в WebdriverIO можно использовать стандартные команды, такие как waitForExist и waitForClickable:

await $('#elementId').waitForExist({ timeout: 5000 });
await $('#elementId').waitForClickable({ timeout: 5000 });

Это значительно упрощает код и уменьшает вероятность ошибок из-за неправильно настроенных ожиданий.

5. Управление тестами

WebdriverIO позволяет интегрировать различные фреймворки тестирования, такие как Mocha, Jasmine, и Cucumber. Это дает гибкость в выборе подхода к тестированию и упрощает интеграцию с другими инструментами.

Пример настройки для Mocha:

exports.config = {
    framework: 'mocha',
    reporters: ['spec'],
    services: ['chromedriver'],
    capabilities: [{
        browserName: 'chrome'
    }]
};

В отличие от Selenium, где конфигурация тестов может быть более сложной, в WebdriverIO процесс настройки тестов и фреймворков намного проще и удобнее, благодаря встроенным инструментам.

6. Обработка ошибок и логирование

WebdriverIO предоставляет более гибкую и удобную систему обработки ошибок и логирования, чем Selenium. В Selenium для каждой ошибки можно вручную прописывать обработку, например, использовать try-catch или специфические методы для сбора логов.

В WebdriverIO же можно использовать встроенные методы для логирования, например, browser.log и browser.getLogs, что позволяет более удобно и наглядно отслеживать ошибки:

const logs = await browser.getLogs('browser');
console.log(logs);

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

7. Интеграция с CI/CD

WebdriverIO легко интегрируется с системами непрерывной интеграции и доставки (CI/CD), такими как Jenkins, GitLab CI, CircleCI и другими. Интеграция с CI/CD позволяет автоматизировать процесс запуска тестов и следить за их состоянием в реальном времени.

Конфигурация WebdriverIO для CI может включать установку сервисов и команд, которые автоматически настраивают окружение для тестирования:

exports.config = {
    services: ['selenium-standalone'],
    reporters: ['allure'],
    capabilities: [{
        browserName: 'chrome',
        'goog:chromeOptions': {
            args: ['--headless', '--disable-gpu', '--no-sandbox']
        }
    }]
};

Запуск тестов на CI/CD позволяет убедиться, что приложение работает правильно, не зависимо от изменений в коде, что делает автоматическое тестирование незаменимым инструментом в разработке.

8. Поддержка мобильных платформ

WebdriverIO также поддерживает автоматизацию тестов для мобильных устройств с использованием Appium, что делает его удобным инструментом для тестирования как веб-приложений, так и мобильных приложений.

Настройка для работы с мобильными устройствами через Appium:

exports.config = {
    services: ['appium'],
    capabilities: [{
        platformName: 'Android',
        deviceName: 'emulator-5554',
        app: '/path/to/app.apk'
    }]
};

Это расширяет возможности WebdriverIO и делает его универсальным инструментом для тестирования разных типов приложений.

9. Советы по миграции

  • Изучение API: Знакомство с документацией WebdriverIO поможет быстрее адаптироваться к новому синтаксису и особенностям работы с инструментом.
  • Переписывание тестов: Процесс миграции требует переписывания тестов, чтобы использовать новый API WebdriverIO. Лучше всего это делать поэтапно, начиная с простых тестов.
  • Использование ассинхронных операций: Важно правильно использовать async/await, так как это позволяет избежать ошибок синхронизации.
  • Интеграция с CI: Убедитесь, что тесты корректно интегрированы с CI/CD, чтобы в дальнейшем не возникло проблем с автоматическим запуском.

Процесс миграции с Selenium на WebdriverIO может быть сложным, но его преимущества — повышенная производительность, удобство работы и интеграция с современными инструментами — оправдывают усилия.

Оглавление