hermione

Hermione

Установка

npm i hermione --save-dev

Запуск тестов

node_modules/.bin/hermione path/to/tests --baseUrl http://yandex.ru/search --grid http://localhost:4444/wd/hub

Конфигурация

hermione настраивается с помощью конфигурационного файла. Путь к этому файлу можно задать с помощью опции --conf. Стандартное имя файла - .hermione.conf.js.

Ниже приведён пример полного конфига. Обязательными полями являются specs и browsers.

var command = require('path/to/command');

module.exports = {
    grid: 'http://localhost:4444/wd/hub',
    baseUrl: 'http://yandex.ru/search',
    waitTimeout: 10000,
    debug: true,
    sessionsPerBrowser: 2,
    retry: 2,

    plugins: {
        'my-cool-plugin': {
            param: 'value'
        }
    },

    specs: [
        'tests/desktop',
        'tests/touch'
    ],

    browsers: {
        chrome: {
            desiredCapabilities: {
                browserName: 'chrome'
            },
            sessionsPerBrowser: 3,
            retry: 3
        },

        firefox: {
            desiredCapabilities: {
                browserName: 'firefox'
            },
            sessionsPerBrowser: 10 // по умолчанию тесты запускаются в одной сессии
        }
    },

    // Дополнительная настройка mocha
    mochaOpts: {
        retries: 3
    },

    prepareBrowser: function (browser) {
        browser.addCommand('command', command);
    },

    // Кастомизация окружения
    prepareEnvironment: function() {
        if (process.env.desktop) {
            this.specs = ['tests/desktop'];
        }
    }
};

Описание конфигурационного файла

Настройки браузеров

Браузеры, в которых необходимо запускать тесты, настраиваются в секции browsers. Формат секции:

browsers: {
    <browser_id> {
        <setting>:<value>
        <setting>:<value>
    }
}

Значение <browser-id> используется в отчёте для идентификации браузера. Доступные настройки браузера:

• desiredCapabilities (обязательная) - Необходимые для этого браузера WebDriver DesiredCapabilites
• sessionsPerBrowser - Количество одновременно запущеных сессий для браузера с данным id. По умолчанию 1.
• retry - Сколько раз тест может быть перезапущен. По умолчанию 0.

Подготовка webdriver-сессии к работе

Подготовка сессии к работе (например, установка специфических для пользователя команд) выполняется в секции prepareBrowser. Формат секции:

prepareBrowser: function(browser) {
    // do setup here
}

В данную функцию будет передана сессия webdriver.io.

Кастомизация настройки окружения

Данные в конфиге можно изменять в зависимости от дополнительных условий в функции prepareEnvironment. Использование этой функции не обязательно, она для удобства.

Плагины

hermione поддерживает расширения. Плагин представляет из себя модуль, экспортирующий одну единственную функцию. Эта функция принимает на вход два параметра:

• инстанс hermione
• опции плагина из конфига

В момент запуска тестов плагин будет загружен и вызван с текущим инстансом hermione и опциями конфига, соответствующими данному плагину.

Если название модуля плагина начинается с hermione-, то в конфиге этот префикс можно опустить. Если в зависимостях есть два модуля, например hermione-some-module и some-module, то приоритет отдается модулю с префиксом.

Пример.

// .hermione.conf.js
...
plugins: {
    'my-cool-plugin': {
        param: 'value'
    }
}
...

// hermione-my-cool-plugin/index.js
module.exports = function(hermione, opts) {
    hermione.on(hermione.events.RUNNER_START, function() {
        return setUp(hermione.config, opts.param); // config can be mutated
    });

    hermione.on(hermione.events.RUNNER_END, function() {
        return tearDown();
    });
}

Свойства объекта hermione:

• config - конфиг, который используется в раннере. Может быть модифицирован
• events - список событий, на которые можно подписаться

События

• RUNNER_START - триггерится перед запуском тестов. Обработчик может вернуть промис, тесты запустятся только после того как промис зарезолвится
• RUNNER_END - триггерится после завершения всех тестов. Аналогично RUNNER_START, обработчик может вернуть промис
• SUITE_BEGIN - запустился новый сьют
• SUITE_END - сьют завершен
• TEST_BEGIN - тест пошел на исполнение
• TEST_END - тест завершился
• TEST_PASS - тест пройден
• TEST_FAIL - тест упал
• TEST_PENDING - тест скипнут
• RETRY - тест упал, но ушел на retry
• ERROR - произошла какая-то ошибка не в тесте, например не поднялся браузер
• INFO - (зарезервировано)
• WARNING - (зарезервировано)
• EXIT - триггерится когда получен сигнал на завершение (например при нажатии на Ctrl + C). Обработчик может вернуть промис

Прочие свойства

• specs(обязательный) - Массив путей до директорий с тестами.
• grid – URL до Selenium grid. По умолчанию http://localhost:4444/wd/hub
• baseUrl - Базовый URL тестируемой страницы. По умолчанию localhost
• timeout - Время ожидания выполнения теста. По умолчанию 60000
• waitTimeout - Время ожидания события на странице. По умолчанию 10000
• slow - Если время выполнения теста превышает это значение, то тест считается медленным. По умолчанию 10000
• debug - Включает вывод отладочной информации в консоль. По умолчанию false
• sessionsPerBrowser - Глобальное значение опции sessionsPerBrowser для всех браузеров
• retry - Глобальное значение опции retry для всех браузеров

Переопределение настроек

С помощью CLI можно переопределить параметры, используя следующие опции:

• -c|--conf - указать путь к конфигу. По умолчанию используется файл с именем .hermione.conf.js
• --baseUrl - задать базовый url для всех тестов
• --wait-timeout - время ожидания событий на странице в миллисекундах. По умолчанию 10000
• -b|--browser - запуск тестов в определенном браузере. Возможно задать несколько браузеров одновременно. Например,

node_modules/.bin/hermione -b chrome --browser firefox

• -r|--reporter - указать используемый репортер. Возможно задать несколько репортеров одновременно. Например,

node_modules/.bin/hermione -r flat --reporter teamcity

• --debug - включить debug-режим