diff --git a/package.json b/package.json index c7abf2380..993f69c0c 100644 --- a/package.json +++ b/package.json @@ -5,7 +5,8 @@ "description": "Build tools for Echo.", "scripts": { "test": "grunt test", - "doc": "jsduck" + "doc": "jsduck", + "selenium-test": "wdio tests/selenium/wdio.conf.js" }, "devDependencies": { "eslint-config-wikimedia": "0.5.0", @@ -14,9 +15,13 @@ "grunt-contrib-watch": "1.0.0", "grunt-eslint": "20.1.0", "grunt-jsonlint": "1.1.0", - "grunt-svgmin": "5.0.0", "grunt-stylelint": "0.9.0", + "grunt-svgmin": "5.0.0", "stylelint": "8.2.0", - "stylelint-config-wikimedia": "0.4.2" + "stylelint-config-wikimedia": "0.4.2", + "wdio-mediawiki": "0.1.7", + "wdio-mocha-framework": "0.5.13", + "wdio-spec-reporter": "0.1.4", + "webdriverio": "4.12.0" } } diff --git a/tests/selenium/.eslintrc.json b/tests/selenium/.eslintrc.json index b2d0bdd9f..5efe15d09 100644 --- a/tests/selenium/.eslintrc.json +++ b/tests/selenium/.eslintrc.json @@ -1,5 +1,5 @@ { - "extends": "../../.eslintrc.json", + "extends": "wikimedia", "env": { "es6": true, "mocha": true, @@ -7,5 +7,8 @@ }, "globals": { "browser": false + }, + "rules": { + "no-console": 0 } } diff --git a/tests/selenium/wdio.conf.js b/tests/selenium/wdio.conf.js new file mode 100644 index 000000000..3b58beb6d --- /dev/null +++ b/tests/selenium/wdio.conf.js @@ -0,0 +1,88 @@ +/** + * See also: http://webdriver.io/guide/testrunner/configurationfile.html + */ +const fs = require( 'fs' ), + saveScreenshot = require( 'wdio-mediawiki' ).saveScreenshot; + +exports.config = { + // ====== + // Custom WDIO config specific to MediaWiki + // ====== + // Use in a test as `browser.options.`. + // Defaults are for convenience with MediaWiki-Vagrant + + // Wiki admin + username: process.env.MEDIAWIKI_USER || 'Admin', + password: process.env.MEDIAWIKI_PASSWORD || 'vagrant', + + // Base for browser.url() and Page#openTitle() + baseUrl: ( process.env.MW_SERVER || 'http://127.0.0.1:8080' ) + ( + process.env.MW_SCRIPT_PATH || '/w' + ), + + // ================== + // Test Files + // ================== + specs: [ + __dirname + '/specs/*.js' + ], + + // ============ + // Capabilities + // ============ + capabilities: [ { + // https://sites.google.com/a/chromium.org/chromedriver/capabilities + browserName: 'chrome', + maxInstances: 1, + chromeOptions: { + // If DISPLAY is set, assume developer asked non-headless or CI with Xvfb. + // Otherwise, use --headless (added in Chrome 59) + // https://chromium.googlesource.com/chromium/src/+/59.0.3030.0/headless/README.md + args: [ + ...( process.env.DISPLAY ? [] : [ '--headless' ] ), + // Chrome sandbox does not work in Docker + ...( fs.existsSync( '/.dockerenv' ) ? [ '--no-sandbox' ] : [] ) + ] + } + } ], + + // =================== + // Test Configurations + // =================== + + // Level of verbosity: silent | verbose | command | data | result | error + logLevel: 'error', + + // Setting this enables automatic screenshots for when a browser command fails + // It is also used by afterTest for capturig failed assertions. + screenshotPath: process.env.LOG_DIR || __dirname + '/log', + + // Default timeout for each waitFor* command. + waitforTimeout: 10 * 1000, + + // See also: http://webdriver.io/guide/testrunner/reporters.html + reporters: [ 'spec' ], + + // See also: http://mochajs.org + mochaOpts: { + ui: 'bdd', + timeout: 60 * 1000 + }, + + // ===== + // Hooks + // ===== + + /** + * Save a screenshot when test fails. + * + * @param {Object} test Mocha Test object + */ + afterTest: function ( test ) { + var filePath; + if ( !test.passed ) { + filePath = saveScreenshot( test.title ); + console.log( '\n\tScreenshot: ' + filePath + '\n' ); + } + } +};