Infinni-ui-e2e NPM

infinni-ui-e2e

Фреймворк для создания интеграционных тестов в проектах использующих контролы из infinni-ui

Инструкция по запуску.

1) Все сценарии рекомендуется поместить в директорию "./features/".

2) Перед запуском необходимо создать config.js файл и экспортировать из него необходимые параметры. Подробнее про возможные параметры здесь.

3) При необходимости, можно создать файл extensions.js с расширением стандартного функционала. Файл необходимо разместить в директории "./features/support/". Подробнее здесь.

4) При необходимости можно создать свои определения шагов. Данные файлы необходимо разместить в директории "./features/step_definitions/". Подробнее здесь.

5) Установить все зависимости командой "npm install".

6) Запустить тестирование командой "npm test", предварительно добавив ее в package.json. В package.json в scripts необходимо добавить команду запуска интеграционных тестов 'iui-e2e --config-file:<путь до конфиг файла(например, '/config')>'

Default parameters

    var path = require( 'path' );

    module.exports = {

        timeouts: {
            main: 10000,
            wait: 10
        },

        // absolute path to screenshots folder
        screenshotsFolder: path.resolve( __dirname, 'screenshots' ),

        defaultBrowserName: 'chrome',

        checkLoader: true,

        screen: {
            width: 1920,
            height: 1080
        },

        // browsers options for webdriver
        browsers: {
            chrome: {
                'methodName': 'arguments'
            },
            firefox: {
                'methodName': 'arguments'
            },
            opera: {
                'methodName': 'arguments'
            },
            ie: {
                'methodName': 'arguments'
            },
            edge: {
                'methodName': 'arguments'
            },
            safari: {
                'methodName': 'arguments'
            },
            phantomjs: {
                'optionName': 'value'
            }
        },

        // folder for search by cucumber
        // add here absolute path for your 'features' folder
        folders: [
            path.resolve( __dirname, 'features' ) // folder with default files will add automitically
        ],

        // all user options goes here
        userOptions: {
            // host: 'http://localhost:8080',
            // browser: 'browser_name',
            // teamcity: true,
            // width: 'some_width',
            // height: 'some_height',
        },

        // all cucumber options goes here
        options: {
            '--tags': 'not @ignore',
            '--format': 'summary'
        }

    };

Parameters

Позволяют задать различные настройки для запуска тестов. Объект с параметрами всегда доступен во время выполнения тестов через глобальный объект process.myConfig.

timeouts - установка дополнительных таумаутов.
screenshotsFolder - абсолютный путь до директории куда помещать скриншоты при ошибках
defaultBrowserName - браузер по умолчанию.
screen - разрешение браузера во время тестов.
browsers - различные настройки для каждого браузера. Подробно про настройки каждого браузера здесь.
folders - папки в которых находятся сценарии и дополнительные определения шагов.
userOptions - пользовательские параметры, которые позволяют менять конфигурацию. Есть возможность передачи через командную строку. Они имеют синтаксис вида "--parameterKey:parameterValue". Подробнее здесь.

Пример:

    userOptions: {
        host: 'http://localhost:8080',
        browser: 'opera',
        teamcity: true,
        width: '2500',
        height: '1440'
    }

options - параметры для cucumber'a передаются в виде объекта где key это полное имя параметра через стандартный синтаксис cucumber'a, а value это полное значение. Так же можно передавать их в командную строку через стандартный синтаксис cucumber'a. Подробнее про параметры cucumber'a здесь.

Пример:

    options: {
        '--tags': 'not @ignore',
        '--format': 'summary'
    }

User options

Все параметры всегда доступны через глобальный объект process.myConfig.userOptions.

host - адрес сервиса
browser - позволяет указать браузер который будет использоваться для запуска тестов. Допустимые значения: 'chrome', 'firefox', 'ie', 'opera', 'edge', 'safari', 'phantomjs'. Для работы браузеров необходимо скачать их вебдрайверы здесь и добавить в переменную окружения PATH путь до папки где лежат эти драйвера.
teamcity - запуск тестов на teamcity. Допустимые значения true, false.
width - ширина экрана браузера
height - высота экрана браузера

Extensions

Позволяют зарегистрировать дополнительные подписки на события. Список событий можно посмотреть здесь. Внутри подписок нет доступа до глобального объекта world, поэтому он доступен только через глобальный объект process.world.

Пример создания дополнительной подписки.

    var cucumber = require( 'cucumber' );

    cucumber.defineSupportCode( function( consumer ) {

        consumer.registerHandler( 'BeforeScenario', function( scenario ) {
            return new Promise( function( resolve, reject ) {

                var world = process.world;

                // your code

                resolve();
            } );
        } );

    } );

Step definitions

Позволяют создать описание для кастомных шагов, которых нет в infinni-ui. Внутри описания шага в объекте this доступен глобальный объект world. Синтаксис создания описания шага можно посмотреть здесь.

Пример описания шага

    var cucumber = require( 'cucumber' );

    cucumber.defineSupportCode( function( consumer ) {

        consumer.Then( /^замри на "([^"]*)"$/, function( time ) {
            return new Promise( function( resolve ) {
                setTimeout( resolve, parseInt( time ) * 1000 );
            } );
        } );

        consumer.When( /^я пройду проверку безопасности$/, function() {
            return new Promise( function( resolve, reject ) {

                // some code here

                resolve( /* some result */ );
            } );
        } );

    } );