webdriverio 4.9.10 → 4.10.2

package/CHANGELOG.md

@@ -1,5 +1,34 @@
 # CHANGELOG
 
+## v4.10.2 (2018-02-02)
+* global changes:
+    * docs improvements
+* bugfixes:
+    * better unknown command detection (#2580)
+
+## v4.10.1 (2018-01-12)
+* bugfixes:
+    * fallback to old JSONWireProtocol commands when running Chromedriver
+
+## v4.10.0 (2018-01-10)
+* bugfixes:
+    * Fix for error handling on before/after hooks (#2497)
+    * fix debug functionality when using launcher programmatically (#2492)
+    * Fix issue when terminal doesn't support colors (#2496)
+* global changes:
+    * docs improvements
+    * fallbacks for depcrecated JsonWireProtocol commands (#2493)
+* wdio changes
+    * Add ability to specify a spec and suite (#2505)
+    * Add support for filtering specs #2520
+
+## v4.9.11 (2017-11-29)
+* bugfixes:
+    * better handling of failures in before hooks placed before any describe block (#2259)
+    * fix waitForVisible handling (#2486)
+* docs:
+    * add Mochawesome reporter
+
 ## v4.9.10 (2017-11-27)
 * bugfixes:
     * fix launcher run by node script as child process (#2477)

package/build/lib/cli.js

@@ -56,13 +56,13 @@ var SUPPORTED_FRAMEWORKS = ['mocha', // https://github.com/webdriverio/wdio-moch
 'jasmine', // https://github.com/webdriverio/wdio-jasmine-framework
 'cucumber' // https://github.com/webdriverio/wdio-cucumber-framework
 ];
-var SUPPORTED_REPORTER = [' dot - https://github.com/webdriverio/wdio-dot-reporter', ' spec - https://github.com/webdriverio/wdio-spec-reporter', ' junit - https://github.com/webdriverio/wdio-junit-reporter', ' allure - https://github.com/webdriverio/wdio-allure-reporter', ' teamcity - https://github.com/sullenor/wdio-teamcity-reporter', ' json - https://github.com/fijijavis/wdio-json-reporter', ' concise - https://github.com/FloValence/wdio-concise-reporter', ' testrail - https://github.com/oxynade/wdio-testrail-reporter'];
-var SUPPORTED_SERVICES = [' sauce - https://github.com/webdriverio/wdio-sauce-service', ' browserstack - https://github.com/itszero/wdio-browserstack-service', ' testingbot - https://github.com/testingbot/wdio-testingbot-service', ' appium - https://github.com/rhysd/wdio-appium-service', ' firefox-profile - https://github.com/webdriverio/wdio-firefox-profile-service', ' selenium-standalone - https://github.com/webdriverio/wdio-selenium-standalone-service', ' phantomjs - https://github.com/cognitom/wdio-phantomjs-service', ' static-server - https://github.com/LeadPages/wdio-static-server-service', ' visual-regression - https://github.com/zinserjan/wdio-visual-regression-service', ' webpack - https://github.com/leadpages/wdio-webpack-service', ' webpack-dev-server - https://gitlab.com/Vinnl/wdio-webpack-dev-server-service', ' chromedriver - https://github.com/atti187/wdio-chromedriver-service', ' iedriver - https://github.com/atti187/wdio-iedriver-service'];
+var SUPPORTED_REPORTER = [' dot - https://github.com/webdriverio/wdio-dot-reporter', ' spec - https://github.com/webdriverio/wdio-spec-reporter', ' junit - https://github.com/webdriverio/wdio-junit-reporter', ' allure - https://github.com/webdriverio/wdio-allure-reporter', ' teamcity - https://github.com/sullenor/wdio-teamcity-reporter', ' json - https://github.com/fijijavis/wdio-json-reporter', ' concise - https://github.com/FloValence/wdio-concise-reporter', ' testrail - https://github.com/oxynade/wdio-testrail-reporter', ' mochawesome - https://github.com/fijijavis/wdio-mochawesome-reporter'];
+var SUPPORTED_SERVICES = [' sauce - https://github.com/webdriverio/wdio-sauce-service', ' browserstack - https://github.com/itszero/wdio-browserstack-service', ' testingbot - https://github.com/testingbot/wdio-testingbot-service', ' appium - https://github.com/rhysd/wdio-appium-service', ' firefox-profile - https://github.com/webdriverio/wdio-firefox-profile-service', ' selenium-standalone - https://github.com/webdriverio/wdio-selenium-standalone-service', ' phantomjs - https://github.com/cognitom/wdio-phantomjs-service', ' static-server - https://github.com/LeadPages/wdio-static-server-service', ' visual-regression - https://github.com/zinserjan/wdio-visual-regression-service', ' webpack - https://github.com/leadpages/wdio-webpack-service', ' webpack-dev-server - https://gitlab.com/Vinnl/wdio-webpack-dev-server-service', ' chromedriver - https://github.com/atti187/wdio-chromedriver-service', ' iedriver - https://github.com/atti187/wdio-iedriver-service', ' docker - https://github.com/stsvilik/wdio-docker-service'];
 
 var VERSION = _package2.default.version;
 var ALLOWED_ARGV = ['host', 'port', 'path', 'user', 'key', 'logLevel', 'coloredLogs', 'screenshotPath', 'baseUrl', 'waitforTimeout', 'framework', 'reporters', 'suite', 'spec', 'cucumberOpts', 'jasmineOpts', 'mochaOpts', 'connectionRetryTimeout', 'connectionRetryCount', 'watch'];
 
-_optimist2.default.usage('WebdriverIO CLI runner\n\n' + 'Usage: wdio [options] [configFile]\n' + 'Usage: wdio config\n' + 'Usage: wdio repl [browserName]\n' + 'config file defaults to wdio.conf.js\n' + 'The [options] object will override values from the config file.\n' + 'An optional list of spec files can be piped to wdio that will override configured specs.').describe('help', 'prints WebdriverIO help menu').alias('help', 'h').describe('version', 'prints WebdriverIO version').alias('version', 'v').describe('host', 'Selenium server host address').describe('port', 'Selenium server port').describe('path', 'Selenium server path (default: /wd/hub)').describe('user', 'username if using a cloud service as Selenium backend').alias('user', 'u').describe('key', 'corresponding access key to the user').alias('key', 'k').describe('watch', 'watch specs for changes').describe('logLevel', 'level of logging verbosity (default: silent)').alias('logLevel', 'l').describe('coloredLogs', 'if true enables colors for log output (default: true)').alias('coloredLogs', 'c').describe('bail', 'stop test runner after specific amount of tests have failed (default: 0 - don\'t bail)').describe('screenshotPath', 'saves a screenshot to a given path if a command fails').alias('screenshotPath', 's').describe('baseUrl', 'shorten url command calls by setting a base url').alias('baseUrl', 'b').describe('waitforTimeout', 'timeout for all waitForXXX commands (default: 1000ms)').alias('waitforTimeout', 'w').describe('framework', 'defines the framework (Mocha, Jasmine or Cucumber) to run the specs (default: mocha)').alias('framework', 'f').describe('reporters', 'reporters to print out the results on stdout').alias('reporters', 'r').describe('suite', 'overwrites the specs attribute and runs the defined suite').describe('spec', 'run only a certain spec file - overrides specs piped from stdin').describe('cucumberOpts.*', 'Cucumber options, see the full list options at https://github.com/webdriverio/wdio-cucumber-framework#cucumberopts-options').describe('jasmineOpts.*', 'Jasmine options, see the full list options at https://github.com/webdriverio/wdio-jasmine-framework#jasminenodeopts-options').describe('mochaOpts.*', 'Mocha options, see the full list options at http://mochajs.org').string(['host', 'path', 'user', 'key', 'logLevel', 'screenshotPath', 'baseUrl', 'framework', 'reporters', 'suite', 'spec']).boolean(['coloredLogs', 'watch']).default({ coloredLogs: true }).check(function (arg) {
+_optimist2.default.usage('WebdriverIO CLI runner\n\n' + 'Usage: wdio [options] [configFile]\n' + 'Usage: wdio config\n' + 'Usage: wdio repl [browserName]\n' + 'config file defaults to wdio.conf.js\n' + 'The [options] object will override values from the config file.\n' + 'An optional list of spec files can be piped to wdio that will override configured specs.').describe('help', 'prints WebdriverIO help menu').alias('help', 'h').describe('version', 'prints WebdriverIO version').alias('version', 'v').describe('host', 'Selenium server host address').describe('port', 'Selenium server port').describe('path', 'Selenium server path (default: /wd/hub)').describe('user', 'username if using a cloud service as Selenium backend').alias('user', 'u').describe('key', 'corresponding access key to the user').alias('key', 'k').describe('watch', 'watch specs for changes').describe('logLevel', 'level of logging verbosity (default: silent)').alias('logLevel', 'l').describe('coloredLogs', 'if true enables colors for log output (default: true)').alias('coloredLogs', 'c').describe('bail', 'stop test runner after specific amount of tests have failed (default: 0 - don\'t bail)').describe('screenshotPath', 'saves a screenshot to a given path if a command fails').alias('screenshotPath', 's').describe('baseUrl', 'shorten url command calls by setting a base url').alias('baseUrl', 'b').describe('waitforTimeout', 'timeout for all waitForXXX commands (default: 1000ms)').alias('waitforTimeout', 'w').describe('framework', 'defines the framework (Mocha, Jasmine or Cucumber) to run the specs (default: mocha)').alias('framework', 'f').describe('reporters', 'reporters to print out the results on stdout').alias('reporters', 'r').describe('suite', 'overwrites the specs attribute and runs the defined suite').describe('spec', 'specifies spec file(s) to run or filter(s) for specs defined in the specs attribute').describe('cucumberOpts.*', 'Cucumber options, see the full list options at https://github.com/webdriverio/wdio-cucumber-framework#cucumberopts-options').describe('jasmineOpts.*', 'Jasmine options, see the full list options at https://github.com/webdriverio/wdio-jasmine-framework#jasminenodeopts-options').describe('mochaOpts.*', 'Mocha options, see the full list options at http://mochajs.org').string(['host', 'path', 'user', 'key', 'logLevel', 'screenshotPath', 'baseUrl', 'framework', 'reporters', 'suite', 'spec']).boolean(['coloredLogs', 'watch']).default({ coloredLogs: true }).check(function (arg) {
     if (arg._.length > 1 && arg._[0] !== 'repl') {
         throw new Error('Error: more than one config file specified');
     }
@@ -237,7 +237,7 @@ WDIO Configuration Helper
         message: 'In which directory should the xunit reports get stored?',
         default: './',
         when: function when(answers) {
-            return answers.reporters === 'junit';
+            return answers.reporters.indexOf('junit') !== -1;
         }
     }, {
         type: 'input',
@@ -245,7 +245,15 @@ WDIO Configuration Helper
         message: 'In which directory should the json reports get stored?',
         default: './',
         when: function when(answers) {
-            return answers.reporters === 'json';
+            return answers.reporters.indexOf('json') !== -1;
+        }
+    }, {
+        type: 'input',
+        name: 'outputDir',
+        message: 'In which directory should the mochawesome json reports get stored?',
+        default: './',
+        when: function when(answers) {
+            return answers.reporters.indexOf('mochawesome') !== -1;
         }
     }, {
         type: 'list',

package/build/lib/commands/getElementSize.js

@@ -102,7 +102,7 @@ var getElementSize = function getElementSize(selector, prop) {
     *
     * @alias browser.getElementSize
     * @param   {String}  selector element with requested size
-    * @param   {String*} prop     size to receive (optional "width|height")
+    * @param   {String*} prop     size to receive [optional] ("width" or "height")
     * @return {Object|Number}    requested element size (`{ width: <Number>, height: <Number> }`) or actual width/height as number if prop param is given
     * @uses protocol/elements, protocol/elementIdSize
     * @type property

package/build/lib/commands/getValue.js

@@ -23,7 +23,7 @@ var getValue = function getValue(selector) {
             throw new _ErrorHandler.CommandError(7, selector || _this.lastResult.selector);
         }
 
-        var elementIdAttributeCommands = [];
+        var elementIdPropertyCommands = [];
         var _iteratorNormalCompletion = true;
         var _didIteratorError = false;
         var _iteratorError = undefined;
@@ -32,7 +32,7 @@ var getValue = function getValue(selector) {
             for (var _iterator = (0, _getIterator3.default)(res.value), _step; !(_iteratorNormalCompletion = (_step = _iterator.next()).done); _iteratorNormalCompletion = true) {
                 var elem = _step.value;
 
-                elementIdAttributeCommands.push(_this.elementIdAttribute(elem.ELEMENT, 'value'));
+                elementIdPropertyCommands.push(_this.elementIdProperty(elem.ELEMENT, 'value'));
             }
         } catch (err) {
             _didIteratorError = true;
@@ -49,7 +49,7 @@ var getValue = function getValue(selector) {
             }
         }
 
-        return _this.unify(elementIdAttributeCommands, {
+        return _this.unify(elementIdPropertyCommands, {
             extractValue: true
         });
     });
@@ -73,7 +73,7 @@ var getValue = function getValue(selector) {
     * @alias browser.getValue
     * @param   {String} selector input, textarea, or select element
     * @return {String}          requested input value
-    * @uses protocol/elements, protocol/elementIdAttribute
+    * @uses protocol/elements, protocol/elementIdProperty
     * @type property
     *
     */

package/build/lib/commands/touchAction.js

@@ -67,12 +67,20 @@ function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { de
             'release'
         ])
 
+        // multi action using x y variables
+        // moveTo location is relative from the starting coordinate
+        browser.touchAction([
+            { action: 'press', x: 20, y: 550 },
+            { action: 'moveTo', x: 0, y: -500},
+            'release'
+        ])
+
         // drag&drop to element
         screen.touchAction([
             'press',
             { action: 'moveTo', selector: '//UIAApplication[1]/UIAElement[2]' },
             'release'
-        ]))
+        ])
     });
 
     :multiTouchAction.js
@@ -80,7 +88,7 @@ function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { de
         // drag&drop with two fingers 200px down
         browser.touchAction([
             [{action: 'press', x:  10, y: 10}, { action: 'moveTo', x: 0, y: 200 }, 'release'],
-            [{action: 'press', x: 100, y: 10}, { action: 'moveTo', x: 0, y: 200 }, 'release']]
+            [{action: 'press', x: 100, y: 10}, { action: 'moveTo', x: 0, y: 200 }, 'release']
         ])
     })
  * </example>

package/build/lib/helpers/utilities.js

@@ -15,13 +15,6 @@ function isSuccessfulResponse() {
         body = _ref.body,
         statusCode = _ref.statusCode;
 
-    /**
-     * check status code
-     */
-    if (statusCode === 200) {
-        return true;
-    }
-
     /**
      * response contains a body
      */
@@ -44,6 +37,13 @@ function isSuccessfulResponse() {
         return false;
     }
 
+    /**
+     * check status code
+     */
+    if (statusCode === 200) {
+        return true;
+    }
+
     /**
      * that has no error property (Appium only)
      */
@@ -62,7 +62,7 @@ function isUnknownCommand(err) {
     /**
      * when running browser driver directly
      */
-    if (err.message.match(/(did not match a known command|unknown command)/)) {
+    if (err.message.match(/Invalid Command Method/) || err.message.match(/did not match a known command/) || err.message.match(/unknown command/) || err.message.match(/Driver info: driver\.version: unknown/) || err.message.match(/Method has not yet been implemented/) || err.message.match(/did not map to a valid resource/)) {
         return true;
     }
 

package/build/lib/helpers/wdio.conf.ejs

@@ -273,13 +273,13 @@ exports.config = {
     // beforeHook: function () {
     // },
     /**
-     * Hook that gets executed _after_ a hook within the suite starts (e.g. runs after calling
+     * Hook that gets executed _after_ a hook within the suite ends (e.g. runs after calling
      * afterEach in Mocha)
      */
     // afterHook: function () {
     // },
     /**
-     * Function to be executed after a test (in Mocha/Jasmine) or a step (in Cucumber) starts.
+     * Function to be executed after a test (in Mocha/Jasmine) or a step (in Cucumber) ends.
      * @param {Object} test test details
      */
     // afterTest: function (test) {

package/build/lib/launcher.js

@@ -559,18 +559,21 @@ var Launcher = function () {
             var debugHost = '';
             var debugPort = process.debugPort;
             for (var i in process.execArgv) {
-                var _process$execArgv$i$m = process.execArgv[i].match('--(debug|inspect)(?:-brk)?(?:=(.*):)?'),
-                    _process$execArgv$i$m2 = (0, _slicedToArray3.default)(_process$execArgv$i$m, 3),
-                    type = _process$execArgv$i$m2[1],
-                    host = _process$execArgv$i$m2[2];
-
-                if (type) {
-                    debugType = type;
-                }
-                if (host) {
-                    debugHost = `${host}:`;
+                var _debugArgs = process.execArgv[i].match('--(debug|inspect)(?:-brk)?(?:=(.*):)?');
+                if (_debugArgs) {
+                    var _debugArgs2 = (0, _slicedToArray3.default)(_debugArgs, 3),
+                        type = _debugArgs2[1],
+                        host = _debugArgs2[2];
+
+                    if (type) {
+                        debugType = type;
+                    }
+                    if (host) {
+                        debugHost = `${host}:`;
+                    }
                 }
             }
+
             if (debugType) {
                 debugArgs.push(`--${debugType}=${debugHost}${debugPort + processNumber}`);
             }

package/build/lib/protocol/elementIdProperty.js

@@ -0,0 +1,44 @@
+'use strict';
+
+Object.defineProperty(exports, "__esModule", {
+    value: true
+});
+exports.default = elementIdProperty;
+
+var _ErrorHandler = require('../utils/ErrorHandler');
+
+var _utilities = require('../helpers/utilities');
+
+/**
+ *
+ * Get the value of an element's property.
+ *
+ * @param {String} ID             ID of a WebElement JSON object to route the command to
+ * @param {String} propertyName  property name of element you want to receive
+ *
+ * @return {String|null} The value of the property, or null if it is not set on the element.
+ *
+ * @see  https://w3c.github.io/webdriver/webdriver-spec.html#dfn-get-element-property
+ * @type protocol
+ *
+ */
+
+function elementIdProperty(id, propertyName) {
+    var _this = this;
+
+    if (typeof id !== 'string' && typeof id !== 'number' || typeof propertyName !== 'string') {
+        throw new _ErrorHandler.ProtocolError('number or type of arguments don\'t agree with elementIdProperty protocol command');
+    }
+
+    return this.requestHandler.create(`/session/:sessionId/element/${id}/property/${propertyName}`).catch(function (err) {
+        /**
+         * use old path if W3C path failed
+         */
+        if ((0, _utilities.isUnknownCommand)(err)) {
+            return _this.elementIdAttribute(id, propertyName);
+        }
+
+        throw err;
+    });
+}
+module.exports = exports['default'];

package/build/lib/protocol/keys.js

@@ -95,9 +95,6 @@ module.exports = function keys(value) {
  * [here](https://w3c.github.io/webdriver/webdriver-spec.html#keyboard-actions).
  * To do that, the value has to correspond to a key from the table.
  *
- * This command is deprecated and will be removed soon. Make sure you don't use it in your
- * automation/test scripts anymore to avoid errors.
- *
  * @param {String|String[]} value  The sequence of keys to type. An array must be provided. The server should flatten the array items to a single string to be typed.
  *
  * @see  https://github.com/SeleniumHQ/selenium/wiki/JsonWireProtocol#sessionsessionidkeys

package/build/lib/protocol/toggleTouchIdEnrollment.js

@@ -23,6 +23,9 @@ exports.default = toggleTouchIdEnrollment;
  *
  */
 function toggleTouchIdEnrollment() {
-    return this.requestHandler.create('session/:session_id/appium/simulator/toggle_touch_id_enrollment');
+    return this.requestHandler.create({
+        path: '/session/:sessionId/appium/simulator/toggle_touch_id_enrollment',
+        method: 'POST'
+    });
 }
 module.exports = exports['default'];

package/build/lib/protocol/touchId.js

@@ -28,6 +28,9 @@ exports.default = touchId;
 function touchId() {
     var match = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : true;
 
-    return this.requestHandler.create('/session/:sessionId/appium/simulator/touch_id', { match });
+    return this.requestHandler.create({
+        path: '/session/:sessionId/appium/simulator/touch_id',
+        method: 'POST'
+    }, { match });
 }
 module.exports = exports['default'];

package/build/lib/utils/BaseReporter.js

@@ -215,7 +215,7 @@ var BaseReporter = function (_events$EventEmitter) {
     (0, _createClass3.default)(BaseReporter, [{
         key: 'color',
         value: function color(type, str) {
-            if (!_supportsColor2.default) return String(str);
+            if (!_supportsColor2.default.stdout) return String(str);
             return `\u001b[${COLORS[type]}m${str}\u001b[0m`;
         }
     }, {

package/build/lib/utils/ConfigParser.js

@@ -4,6 +4,14 @@ Object.defineProperty(exports, "__esModule", {
     value: true
 });
 
+var _toConsumableArray2 = require('babel-runtime/helpers/toConsumableArray');
+
+var _toConsumableArray3 = _interopRequireDefault(_toConsumableArray2);
+
+var _set = require('babel-runtime/core-js/set');
+
+var _set2 = _interopRequireDefault(_set);
+
 var _getIterator2 = require('babel-runtime/core-js/get-iterator');
 
 var _getIterator3 = _interopRequireDefault(_getIterator2);
@@ -194,6 +202,8 @@ var ConfigParser = function () {
     }, {
         key: 'merge',
         value: function merge() {
+            var _this = this;
+
             var object = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : {};
 
             this._config = (0, _deepmerge2.default)(this._config, object, MERGE_OPTIONS);
@@ -212,44 +222,59 @@ var ConfigParser = function () {
             this._capabilities = (0, _deepmerge2.default)(this._capabilities, this._config.capabilities || defaultTo, MERGE_OPTIONS);
 
             /**
-             * run single spec file only, regardless of multiple-spec specification
+             * run only specified spec files, regardless of multiple-spec specification
+             * If spec is a file on disk, it is set as the current spec, if it is not, it
+             * is treated as a string match filter for the multiple-spec specification.
              */
             if (typeof object.spec === 'string') {
-                var specs = [];
-                var specList = object.spec.split(/,/g);
-
-                var _iteratorNormalCompletion2 = true;
-                var _didIteratorError2 = false;
-                var _iteratorError2 = undefined;
-
-                try {
-                    for (var _iterator2 = (0, _getIterator3.default)(specList), _step2; !(_iteratorNormalCompletion2 = (_step2 = _iterator2.next()).done); _iteratorNormalCompletion2 = true) {
-                        var spec = _step2.value;
+                (function () {
+                    var specs = new _set2.default();
+                    var specList = object.spec.split(/,/g);
+                    var specsList = ConfigParser.getFilePaths(_this._config.specs);
 
+                    var _loop = function _loop(spec) {
                         if (_fs2.default.existsSync(spec)) {
-                            specs.push(_path2.default.resolve(process.cwd(), spec));
+                            specs.add(_path2.default.resolve(process.cwd(), spec));
+                        } else {
+                            specsList.forEach(function (file) {
+                                if (file.match(spec)) {
+                                    specs.add(file);
+                                }
+                            });
                         }
-                    }
-                } catch (err) {
-                    _didIteratorError2 = true;
-                    _iteratorError2 = err;
-                } finally {
+                    };
+
+                    var _iteratorNormalCompletion2 = true;
+                    var _didIteratorError2 = false;
+                    var _iteratorError2 = undefined;
+
                     try {
-                        if (!_iteratorNormalCompletion2 && _iterator2.return) {
-                            _iterator2.return();
+                        for (var _iterator2 = (0, _getIterator3.default)(specList), _step2; !(_iteratorNormalCompletion2 = (_step2 = _iterator2.next()).done); _iteratorNormalCompletion2 = true) {
+                            var spec = _step2.value;
+
+                            _loop(spec);
                         }
+                    } catch (err) {
+                        _didIteratorError2 = true;
+                        _iteratorError2 = err;
                     } finally {
-                        if (_didIteratorError2) {
-                            throw _iteratorError2;
+                        try {
+                            if (!_iteratorNormalCompletion2 && _iterator2.return) {
+                                _iterator2.return();
+                            }
+                        } finally {
+                            if (_didIteratorError2) {
+                                throw _iteratorError2;
+                            }
                         }
                     }
-                }
 
-                if (specs.length === 0) {
-                    throw new Error(`spec file ${object.spec} not found`);
-                }
+                    if (specs.size === 0) {
+                        throw new Error(`spec file ${object.spec} not found`);
+                    }
 
-                this._config.specs = specs;
+                    _this._config.specs = [].concat((0, _toConsumableArray3.default)(specs));
+                })();
             }
 
             /**
@@ -380,7 +405,7 @@ var ConfigParser = function () {
                     throw new Error(`The suite(s) "${suites.join('", "')}" you specified don't exist ` + 'in your config file or doesn\'t contain any files!');
                 }
 
-                specs = suiteSpecs;
+                specs = typeof this._config.spec === `string` ? [].concat((0, _toConsumableArray3.default)(specs), (0, _toConsumableArray3.default)(suiteSpecs)) : suiteSpecs;
             }
 
             if (Array.isArray(capSpecs)) {

package/build/lib/utils/ReporterStats.js

@@ -448,7 +448,7 @@ var ReporterStats = function (_RunnableStats6) {
             }
 
             try {
-                testStats = this.getTestStats(runner);
+                testStats = this.getTestStats(runner) || {};
             } catch (e) {
                 // If a test fails during the before() or beforeEach() hook, it will not yet
                 // have been 'started', so start now
@@ -502,6 +502,9 @@ var ReporterStats = function (_RunnableStats6) {
         value: function testEnd(runner) {
             this.getTestStats(runner).complete();
             this.counts.tests++;
+            if (runner.context) {
+                this.getTestStats(runner).context = runner.context;
+            }
         }
     }, {
         key: 'suiteEnd',

package/build/package.json

@@ -1,7 +1,7 @@
 {
   "name": "webdriverio",
   "description": "A Node.js bindings implementation for the W3C WebDriver protocol",
-  "version": "4.9.10",
+  "version": "4.10.2",
   "homepage": "http://webdriver.io",
   "author": "Camilo Tapia <camilo.tapia@gmail.com>",
   "repository": {

package/docs/guide/getstarted/configuration.md

@@ -122,7 +122,7 @@ Type: `Boolean`<br>
 Default: *true*
 
 ### bail
-If you only want to run your tests until a specific amount of tests have failed use bail (default is 0 - don't bail, run all tests).
+If you only want to run your tests until a specific amount of tests have failed use bail (default is 0 - don't bail, run all tests). _Note_: Please be aware that when using a third party test runner such as Mocha, additional configuration might be required.
 
 Type: `Number`<br>
 Default: *0* (don't bail, run all tests)

package/docs/guide/reporters/allure.md

@@ -60,7 +60,7 @@ Apply and restart the Jenkins server. All assets should now be served correctly.
 Install the [Allure command-line tool](https://www.npmjs.com/package/allure-commandline), and process the results directory:
 
 ```sh
-$ allure generate [allure_output_dir] && allure report open
+$ allure generate [allure_output_dir] && allure open
 ```
 
 This will generate a report (by default in `./allure-report`), and open it in your browser:

package/docs/guide/reporters/dot.md

@@ -8,7 +8,7 @@ title: WebdriverIO - Dot Reporter
 Dot Reporter
 ============
 
-The dot reporter is the default reporter for the WDIO test runner. It's therefor a dependency of WebdriverIO and doesn't need to get downloaded. To use the dot reporter just add `'dot'` to the `reporters` array:
+The dot reporter is the default reporter for the WDIO test runner. It's therefore a dependency of WebdriverIO and doesn't need to get downloaded. To use the dot reporter just add `'dot'` to the `reporters` array:
 
 ```js
 // wdio.conf.js

package/docs/guide/reporters/mochawesome.md

@@ -0,0 +1,67 @@
+name: mochawesome
+category: reporters
+tags: guide
+index: 8
+title: WebdriverIO - Mochawesome Reporter
+---
+
+WDIO Mochawesome Reporter
+=========================
+
+Generates test results in the json formated needed to create [Mochawesome](https://github.com/adamgruber/mochawesome) reports.
+
+
+## Installation
+
+```shell
+npm install --save wdio-mochawesome-reporter
+```
+
+A dependency will be added to your `package.json`
+
+```json
+{
+  "dependencies": {
+    "wdio-mochawesome-reporter": "^1.0.0"
+  }
+}
+```
+
+## Using
+
+ Add to the list of reporters.
+
+```js
+// sample wdio.conf.js
+module.exports = {
+  // ...
+  reporters: ['dot', 'mochawesome'],
+  reporterOptions: {
+    outputDir: './', //json file will be written to this directory
+    mochawesome_filename: 'myfile.json' //will default to wdiomochawesome.json if no name is provided
+  },
+
+  // ...
+};
+```
+
+
+
+## Mochawesome Report Generator
+To convert the json generated by this package into a Mochawesome report you will need to use the [Mochawesome Report Generator](https://github.com/adamgruber/mochawesome-report-generator).
+
+In summary...
+
+* Add the package to your project
+```shell
+npm install --save mochawesome-report-generator
+```
+
+* Add a script to your package.json to generate the report
+```json
+  "scripts": {
+    "generateMochawesome":"marge path/to/results.json --reportTitle 'My Project Results'"
+  },
+```
+1) `path/to/results.json` = path and name of json file
+2) `--reportTitle 'My Project Results' = unique report title