Управление конфигурациями

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

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

Структура конфигурационного файла

Файл wdio.conf.js представляет собой JavaScript файл, который экспортирует объект с различными настройками. Главными разделами конфигурации являются:

  • Секция capabilities: определяет настройки браузера, с которым будет работать WebdriverIO.
  • Секция services: отвечает за подключаемые сервисы, такие как Appium или Selenium.
  • Секция reporters: определяет, какие отчёты и логи будут генерироваться по завершению тестов.
  • Секция framework: указывает на выбранный фреймворк тестирования (например, Mocha, Jasmine или Cucumber).
  • Секция hooks: задаёт функции, которые могут быть выполнены до или после выполнения тестов, например, для подготовки данных или очистки окружения.

Пример базового конфигурационного файла:

exports.config = {
    runner: 'local',
    specs: [
        './tests/**/*.js'
    ],
    capabilities: [{
        browserName: 'chrome',
        'goog:chromeOptions': {
            args: ['--headless']
        }
    }],
    services: ['selenium-standalone'],
    reporters: ['spec'],
    framework: 'mocha',
    mochaOpts: {
        ui: 'bdd',
        timeout: 60000
    },
    before: function () {
        console.log('Тесты начинаются...');
    }
};

Управление capabilities

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

Пример:

capabilities: [{
    browserName: 'firefox',
    'moz:firefoxOptions': {
        args: ['-headless']
    }
}]

Здесь указано, что тесты будут выполняться в браузере Firefox в фоновом (headless) режиме.

Другим важным моментом является поддержка мульти-браузерности. Например, если необходимо тестировать приложение одновременно в нескольких браузерах, можно указать несколько объектов в массиве capabilities:

capabilities: [
    {
        browserName: 'chrome'
    },
    {
        browserName: 'firefox'
    }
]

Использование services

WebdriverIO поддерживает подключение различных сервисов, которые значительно расширяют возможности тестирования. Наиболее часто используемые сервисы:

  • selenium-standalone — позволяет запускать Selenium сервер и драйверы для браузеров.
  • appium — сервис для тестирования мобильных приложений.
  • chromedriver — отдельный сервис для работы с драйвером Chrome.
  • video — сохраняет видео с тестов, что полезно для последующего анализа.

Пример подключения сервиса selenium-standalone:

services: ['selenium-standalone']

Каждый сервис может иметь свои настройки, например, указание версий драйверов или параметры прокси-сервера.

Настройка отчетности с reporters

WebdriverIO поддерживает интеграцию с различными отчетными системами. Раздел reporters позволяет настроить вывод логов и отчётов после завершения выполнения тестов. Среди доступных репортеров:

  • spec — стандартный репортер, выводящий подробную информацию о каждом тесте.
  • junit — генерирует отчёты в формате JUnit, что полезно для интеграции с CI/CD системами.
  • allure — предоставляет графический интерфейс для визуализации результатов тестов.

Пример использования репортера spec:

reporters: ['spec']

А для интеграции с Allure отчётами:

reporters: [['allure', {
    outputDir: 'allure-results'
}]]

Секреты тестирования с hooks

В WebdriverIO hooks используются для выполнения специальных функций до или после тестов. Они позволяют выполнить необходимую настройку или очистку данных, такие как подключение к базе данных, создание тестовых пользователей и так далее.

Примеры:

  • before: выполняется перед началом всех тестов.
  • beforeTest: выполняется перед каждым тестом.
  • afterTest: выполняется после каждого теста.
  • after: выполняется после завершения всех тестов.
before: function () {
    console.log('Подготовка к выполнению тестов...');
},
after: function () {
    console.log('Тесты завершены.');
}

Управление настройками через командную строку

WebdriverIO позволяет настраивать параметры через командную строку, что полезно для запуска тестов с различными параметрами в зависимости от окружения. Это можно сделать с помощью флага --config или использовать переменные окружения для передачи значений.

Пример:

wdio wdio.conf.js --capabilities '{"browserName": "chrome"}'

Также можно передавать параметры через переменные среды. Например:

export BROWSER=chrome
wdio wdio.conf.js

В конфигурационном файле можно использовать переменные окружения:

capabilities: [{
    browserName: process.env.BROWSER || 'chrome'
}]

Параметры фреймворков и тестовых библиотек

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

Для Mocha параметры можно настроить в разделе mochaOpts:

mochaOpts: {
    ui: 'bdd',
    timeout: 60000
}

Для Cucumber используется раздел cucumberOpts:

cucumberOpts: {
    require: ['./steps/**/*.js'],
    backtrace: true
}

Установка и настройка плагинов

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

Пример подключения плагина для автоматической генерации Allure отчетов:

plugins: {
    allure: {
        outputDir: './allure-results',
        disableWebdriverStepsReporting: false
    }
}

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

Советы по настройке конфигураций

  • Использование разных конфигурационных файлов для различных сред (например, для продакшн и для разработки) позволяет легко переключаться между настройками.
  • Параметры для тестовых окружений можно задавать через переменные окружения или с помощью флагов командной строки.
  • Для крупных проектов рекомендуется разделить конфигурацию на несколько частей, например, для настройки окружений, запуска тестов на разных браузерах и других специфичных задач.
  • Не забывайте о безопасности, особенно при работе с конфиденциальными данными, такими как API ключи или учётные данные.

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

Оглавление