webdriverio 4.14.0 → 4.14.4

package/CHANGELOG.md

@@ -1,4 +1,21 @@
 # CHANGELOG
+## unreleased
+* wdio changes
+    * add W3C actions protocol fallback for when moveTo protocol returns an error
+    * add W3C actions protocol fallback for when leftClick, middleClick or rightClick command / buttonDown, buttonPress, or buttonUp protocol returns an error
+
+## v4.14.2 (2019-01-11)
+* bugfix:
+    * fix css-id selector
+    * fix a nullref exception on network failures where response had no body
+
+## v4.14.1 (2018-11-30)
+* global:
+    * add config `region` that allows to specify the SauceLabs datacenter region
+* wdio changes:
+    * Allowing to specify a feature file with a scenario line number (#3019)
+* bugfixes:
+    * round values for touchMove command (#3039)
 
 ## v4.14.0 (2018-10-23)
 * global:

package/build/lib/commands/deleteCookie.js

@@ -53,7 +53,7 @@ var deleteCookie = function deleteCookie(name) {
         name = null;
     }
 
-    return this.cookie('DELETE', name);
+    return this.cookie('DELETE', typeof name === 'string' ? encodeURIComponent(encodeURIComponent(name)) : name);
 };
 
 exports.default = deleteCookie;

package/build/lib/commands/getCookie.js

@@ -49,7 +49,7 @@ var getCookie = function getCookie(name) {
 
         if (typeof name === 'string') {
             return res.value.filter(function (cookie) {
-                return cookie.name === name;
+                return cookie.name === encodeURIComponent(encodeURIComponent(name));
             })[0] || null;
         }
 

package/build/lib/commands/leftClick.js

@@ -17,6 +17,8 @@ var leftClick = function leftClick(selector, xoffset, yoffset) {
     * Apply left click on an element. If selector is not provided, click on the last
     * moved-to location.
     *
+    * Uses JSONWireframe buttonPress protocol with W3C actions protocol as fallback.
+    *
     * @alias browser.leftClick
     * @param {String} selector element to click on
     * @param {Number} xoffset  X offset to move to, relative to the top-left corner of the element.

package/build/lib/commands/middleClick.js

@@ -17,6 +17,8 @@ var middleClick = function middleClick(selector, xoffset, yoffset) {
     * Apply middle click on an element. If selector is not provided, click on the last
     * moved-to location.
     *
+    * Uses JSONWireframe buttonPress protocol with W3C actions protocol as fallback.
+    *
     * @alias browser.middleClick
     * @param {String} selector element to click on
     * @param {Number} xoffset  X offset to move to, relative to the top-left corner of the element.

package/build/lib/commands/moveToObject.js

@@ -9,41 +9,6 @@ var _ErrorHandler = require('../utils/ErrorHandler');
 var moveToObject = function moveToObject(selector, xoffset, yoffset) {
     var _this = this;
 
-    /**
-     * check for offset params
-     */
-    var hasOffsetParams = true;
-    if (typeof xoffset !== 'number' && typeof yoffset !== 'number') {
-        hasOffsetParams = false;
-    }
-
-    if (this.isMobile) {
-        return this.element(selector).then(function (res) {
-            /**
-             * check if element was found and throw error if not
-             */
-            if (!res.value) {
-                throw new _ErrorHandler.RuntimeError(7);
-            }
-
-            return _this.elementIdSize(res.value.ELEMENT).then(function (size) {
-                return _this.elementIdLocation(res.value.ELEMENT).then(function (location) {
-                    return { size, location };
-                });
-            });
-        }).then(function (res) {
-            var x = res.location.value.x + res.size.value.width / 2;
-            var y = res.location.value.y + res.size.value.height / 2;
-
-            if (hasOffsetParams) {
-                x = res.location.value.x + xoffset;
-                y = res.location.value.y + yoffset;
-            }
-
-            return _this.touchMove(x, y);
-        });
-    }
-
     return this.element(selector).then(function (res) {
         /**
          * check if element was found and throw error if not
@@ -60,14 +25,16 @@ var moveToObject = function moveToObject(selector, xoffset, yoffset) {
     * offset, the mouse will be moved to the center of the element. If the element is not
     * visible, it will be scrolled into view.
     *
+    * Uses JSONWireframe moveTo protocol with W3C actions protocol fallback.
+    * Uses touchMove protocol for mobile.
+    *
     * @alias browser.moveToObject
     * @param {String} selector element to move to
     * @param {Number} xoffset  X offset to move to, relative to the top-left corner of the element. If not specified, the mouse will move to the middle of the element.
     * @param {Number} yoffset  Y offset to move to, relative to the top-left corner of the element. If not specified, the mouse will move to the middle of the element.
-    * @uses protocol/element, protocol/elementIdLocation
+    * @uses protocol/element, protocol/elementIdLocation, protocol/elementIdSize
     * @type action
     *
     */
-
 exports.default = moveToObject;
 module.exports = exports['default'];

package/build/lib/commands/rightClick.js

@@ -17,6 +17,8 @@ var rightClick = function rightClick(selector, xoffset, yoffset) {
     * Apply right click on an element. If selector is not provided, click on the last
     * moved-to location.
     *
+    * Uses JSONWireframe buttonPress protocol with W3C actions protocol as fallback.
+    *
     * @alias browser.rightClick
     * @param {String} selector element to click on
     * @param {Number} xoffset  X offset to move to, relative to the top-left corner of the element.

package/build/lib/commands/setCookie.js

@@ -4,17 +4,25 @@ Object.defineProperty(exports, "__esModule", {
     value: true
 });
 
+var _assign = require('babel-runtime/core-js/object/assign');
+
+var _assign2 = _interopRequireDefault(_assign);
+
 var _ErrorHandler = require('../utils/ErrorHandler');
 
+function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
+
 var setCookie = function setCookie(cookieObj) {
+    var name = cookieObj.name;
     /*!
      * parameter check
      */
-    if (typeof cookieObj !== 'object') {
+
+    if (typeof cookieObj !== 'object' || !name || typeof name !== 'string') {
         throw new _ErrorHandler.CommandError('Please specify a cookie object to set (see https://github.com/SeleniumHQ/selenium/wiki/JsonWireProtocol#cookie-json-object for documentation.');
     }
 
-    return this.cookie('POST', cookieObj);
+    return this.cookie('POST', (0, _assign2.default)({}, cookieObj, { name: encodeURIComponent(encodeURIComponent(name)) }));
 }; /**
     *
     * Sets a [cookie](https://github.com/SeleniumHQ/selenium/wiki/JsonWireProtocol#cookie-json-object)

package/build/lib/helpers/detectSeleniumBackend.js

@@ -6,6 +6,15 @@ Object.defineProperty(exports, "__esModule", {
 var DEFAULT_HOST = '127.0.0.1';
 var DEFAULT_PORT = 4444;
 
+var REGION_MAPPING = {
+    'eu': 'eu-central-1'
+};
+
+function getSauceEndpoint(region) {
+    var dc = region ? (REGION_MAPPING[region] || region) + '.' : '';
+    return `${dc}saucelabs.com`;
+}
+
 /**
  * helper to detect the Selenium backend according to given capabilities
  */
@@ -25,6 +34,7 @@ var detectSeleniumBackend = function detectSeleniumBackend(capabilities) {
      */
     if (!capabilities.user || !capabilities.key) {
         return {
+            protocol: 'http',
             host: DEFAULT_HOST,
             port: DEFAULT_PORT
         };
@@ -36,6 +46,7 @@ var detectSeleniumBackend = function detectSeleniumBackend(capabilities) {
      */
     if (capabilities.key.length === 20) {
         return {
+            protocol: 'http',
             host: 'hub.browserstack.com',
             port: 80
         };
@@ -47,6 +58,7 @@ var detectSeleniumBackend = function detectSeleniumBackend(capabilities) {
      */
     if (capabilities.key.length === 32) {
         return {
+            protocol: 'http',
             host: 'hub.testingbot.com',
             port: 80
         };
@@ -58,7 +70,7 @@ var detectSeleniumBackend = function detectSeleniumBackend(capabilities) {
      */
     return {
         protocol: 'https',
-        host: 'ondemand.saucelabs.com',
+        host: capabilities.host || `ondemand.${getSauceEndpoint(capabilities.region)}`,
         port: 443
     };
 };

package/build/lib/helpers/findElementStrategy.js

@@ -48,11 +48,10 @@ var findStrategy = function findStrategy() {
     }
 
     // check value type
-    // use id strategy if value starts with # and doesnt contain any other CSS selector-relevant character
-    // regex to match ids from http://stackoverflow.com/questions/18938390/regex-to-match-ids-in-a-css-file
+    // use css selector for hash instead of by.id
+    // https://github.com/webdriverio/webdriverio/issues/2780
     if (value.search(/^#-?[_a-zA-Z]+[_a-zA-Z0-9-]*$/) > -1) {
-        using = 'id';
-        value = value.slice(1);
+        using = 'css selector';
 
         // use xPath strategy if value starts with //
     } else if (value.indexOf('/') === 0 || value.indexOf('(') === 0 || value.indexOf('../') === 0 || value.indexOf('./') === 0 || value.indexOf('*/') === 0) {

package/build/lib/helpers/findMoveToCoordinates.js

@@ -0,0 +1,42 @@
+'use strict';
+
+Object.defineProperty(exports, "__esModule", {
+    value: true
+});
+/**
+ * call must be scoped to the webdriverio client
+ *
+ * @param {String} element  Opaque ID assigned to the element to move to, as described in the WebElement JSON Object.
+ * @param {Number} xoffset  X offset to move to, relative to the top-left corner of the element. If not specified, the mouse will move to the middle of the element.
+ * @param {Number} yoffset  Y offset to move to, relative to the top-left corner of the element. If not specified, the mouse will move to the middle of the element.
+ * @uses protocol/elementIdLocation, protocol/elementIdSize
+ */
+var findMoveToCoordinates = function findMoveToCoordinates(element, xoffset, yoffset) {
+    var _this = this;
+
+    /**
+     * check for offset params
+     */
+    xoffset = typeof xoffset === 'number' ? xoffset : 0;
+    yoffset = typeof yoffset === 'number' ? yoffset : 0;
+
+    return this.elementIdSize(element).then(function (size) {
+        return _this.elementIdLocation(element).then(function (location) {
+            var x = location.value.x + size.value.width / 2;
+            var y = location.value.y + size.value.height / 2;
+
+            if (xoffset > 0 || yoffset > 0) {
+                x = location.value.x + xoffset;
+                y = location.value.y + yoffset;
+            }
+
+            return {
+                x: Math.round(x),
+                y: Math.round(y)
+            };
+        });
+    });
+};
+
+exports.default = findMoveToCoordinates;
+module.exports = exports['default'];

package/build/lib/helpers/handleMouseButtonProtocol.js

@@ -3,20 +3,53 @@
 Object.defineProperty(exports, "__esModule", {
     value: true
 });
+
+var _utilities = require('../helpers/utilities');
+
 var BUTTON_ENUM = {
     left: 0,
     middle: 1,
     right: 2
+};
+
+var REQUEST_PATH_ENUM = {
+    down: '/session/:sessionId/buttondown',
+    press: '/session/:sessionId/click',
+    up: '/session/:sessionId/buttonup'
 
     /**
      * call must be scoped to the webdriverio client
      */
 };var handleMouseButtonProtocol = function handleMouseButtonProtocol(requestPath, button) {
+    var _this = this;
+
     if (typeof button !== 'number') {
         button = BUTTON_ENUM[button || 'left'];
     }
 
-    return this.requestHandler.create(requestPath, { button: button });
+    return this.requestHandler.create(requestPath, { button: button }).catch(function (err) {
+        /**
+         * jsonwire command not supported try webdriver endpoint
+         */
+        if ((0, _utilities.isUnknownCommand)(err)) {
+            var actions = [{ type: 'pointerDown', button: button }, { type: 'pointerUp', button: button }];
+
+            if (requestPath === REQUEST_PATH_ENUM['down']) {
+                actions = [{ type: 'pointerDown', button: button }];
+            } else if (requestPath === REQUEST_PATH_ENUM['up']) {
+                actions = [{ type: 'pointerUp', button: button }];
+            }
+
+            return _this.actions([{
+                type: 'pointer',
+                id: 'mouse',
+                parameters: { pointerType: 'mouse' },
+                actions
+            }]);
+        }
+
+        return err;
+    });
 };
 
 exports.default = handleMouseButtonProtocol;

package/build/lib/helpers/utilities.js

@@ -5,6 +5,7 @@ Object.defineProperty(exports, "__esModule", {
 });
 exports.isSuccessfulResponse = isSuccessfulResponse;
 exports.isUnknownCommand = isUnknownCommand;
+exports.isUnknownError = isUnknownError;
 exports.formatHostname = formatHostname;
 
 var _net = require('net');
@@ -70,7 +71,7 @@ function isUnknownCommand(err) {
     /**
      * when running browser driver directly
      */
-    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/)) {
+    if (err.message.match(/Command not found/) || 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;
     }
 
@@ -84,6 +85,24 @@ function isUnknownCommand(err) {
     return false;
 }
 
+/**
+ * Checks if the error message is an unknown error
+ * https://w3c.github.io/webdriver/#dfn-unknown-error
+ * @param {Error} err
+ * @return {Boolean} Whether the error message is an "Unknown Error"
+ */
+function isUnknownError(err) {
+    if (!err || typeof err !== 'object') {
+        return false;
+    }
+
+    if (err.message.match(/Unknown error/i)) {
+        return true;
+    }
+
+    return false;
+}
+
 /**
  * Prepare the hostname to properly use IPv6 address
  * @param {string} hostname

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

@@ -25,6 +25,12 @@ exports.config = {
     //
     user: process.env.<%= answers.env_user %>,
     key: process.env.<%= answers.env_key %>,
+    //
+    // If you run your tests on SauceLabs you can specify the region you want to run your tests
+    // in via the `region` property. You can either provide the full region name or the short handle:
+    // us: us-west-1 (default)
+    // eu: eu-central-1
+    // region: 'eu', // for eu-central-1
     <% }
     if(answers.backend.indexOf('In the cloud') > -1) { %>
     <% } %>

package/build/lib/protocol/execute.js

@@ -73,8 +73,11 @@ function execute() {
     return this.requestHandler.create('/session/:sessionId/execute', { script, args }).catch(function (err) {
         /**
          * jsonwire command not supported try webdriver endpoint
+         * Note: MicrosoftWebDriver returns "UnknownError" when receiving
+         *  a jsonwire command in W3C Mode
+         *  https://developer.microsoft.com/en-us/microsoft-edge/platform/issues/19917561/
          */
-        if ((0, _utilities.isUnknownCommand)(err)) {
+        if ((0, _utilities.isUnknownCommand)(err) || (0, _utilities.isUnknownError)(err)) {
             return _this.requestHandler.create('/session/:sessionId/execute/sync', { script, args });
         }
 

package/build/lib/protocol/moveTo.js

@@ -12,6 +12,8 @@ exports.default = moveTo;
 
 var _ErrorHandler = require('../utils/ErrorHandler');
 
+var _utilities = require('../helpers/utilities');
+
 var _eventSimulator = require('../scripts/eventSimulator');
 
 var _eventSimulator2 = _interopRequireDefault(_eventSimulator);
@@ -20,9 +22,15 @@ var _deprecationWarning = require('../helpers/deprecationWarning');
 
 var _deprecationWarning2 = _interopRequireDefault(_deprecationWarning);
 
+var _findMoveToCoordinates = require('../helpers/findMoveToCoordinates');
+
+var _findMoveToCoordinates2 = _interopRequireDefault(_findMoveToCoordinates);
+
 function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
 
 function moveTo(element, xoffset, yoffset) {
+    var _this = this;
+
     var data = {};
 
     if (typeof element === 'string') {
@@ -37,6 +45,12 @@ function moveTo(element, xoffset, yoffset) {
         data.yoffset = yoffset;
     }
 
+    if (this.isMobile) {
+        return _findMoveToCoordinates2.default.call(this, element, xoffset, yoffset).then(function (coordinates) {
+            return _this.touchMove(coordinates.x, coordinates.y);
+        });
+    }
+
     /**
      * if no attribute is set, throw error
      */
@@ -61,7 +75,27 @@ function moveTo(element, xoffset, yoffset) {
         }, { ELEMENT: element }, target.x, target.y);
     }
 
-    return this.requestHandler.create('/session/:sessionId/moveto', data);
+    return this.requestHandler.create('/session/:sessionId/moveto', data).catch(function (err) {
+        /**
+         * jsonwire command not supported try w3c protocol endpoint
+         */
+        if ((0, _utilities.isUnknownCommand)(err)) {
+            return _findMoveToCoordinates2.default.call(_this, element, xoffset, yoffset).then(function (coordinates) {
+                return _this.actions([{
+                    type: 'pointer',
+                    id: 'mouse',
+                    actions: [{
+                        type: 'pointerMove',
+                        duration: 0,
+                        x: coordinates.x,
+                        y: coordinates.y
+                    }]
+                }]);
+            });
+        }
+
+        throw err;
+    });
 } /**
    *
    * Move the mouse by an offset of the specified element. If no element is specified,

package/build/lib/utils/BaseReporter.js

@@ -265,7 +265,22 @@ var BaseReporter = function (_events$EventEmitter) {
         }
 
         /**
-         * Outut the given failures as a list
+         * Output the given passes as a list
+         */
+
+    }, {
+        key: 'listPasses',
+        value: function listPasses() {
+            console.log();
+            this.stats.getPasses().forEach(function (test, i) {
+                var fmt = this.color('green', '%s) %s:\n') + this.color('green', '%s') + this.color('bright yellow', '%s');
+                var title = typeof test.fullTitle !== 'undefined' ? test.fullTitle : typeof test.parent !== 'undefined' ? test.parent + ' ' + test.title : test.title;
+                console.log(fmt, i + 1, title, test.nonerr.message, test.runningBrowser);
+            });
+        }
+
+        /**
+         * Output the given failures as a list
          */
 
     }, {

package/build/lib/utils/ConfigParser.js

@@ -24,21 +24,21 @@ var _createClass2 = require('babel-runtime/helpers/createClass');
 
 var _createClass3 = _interopRequireDefault(_createClass2);
 
-var _fs = require('fs');
+var _deepmerge = require('deepmerge');
 
-var _fs2 = _interopRequireDefault(_fs);
+var _deepmerge2 = _interopRequireDefault(_deepmerge);
 
-var _path = require('path');
+var _fs = require('fs');
 
-var _path2 = _interopRequireDefault(_path);
+var _fs2 = _interopRequireDefault(_fs);
 
 var _glob = require('glob');
 
 var _glob2 = _interopRequireDefault(_glob);
 
-var _deepmerge = require('deepmerge');
+var _path = require('path');
 
-var _deepmerge2 = _interopRequireDefault(_deepmerge);
+var _path2 = _interopRequireDefault(_path);
 
 var _detectSeleniumBackend = require('../helpers/detectSeleniumBackend');
 
@@ -114,6 +114,8 @@ var DEFAULT_CONFIGS = {
 };
 var FILE_EXTENSIONS = ['.js', '.ts', '.feature', '.coffee', '.es6'];
 
+var FEATURE_FILE_SPEC_REGEX = /^(.+\.feature):[0-9]+$/;
+
 var ConfigParser = function () {
     function ConfigParser() {
         (0, _classCallCheck3.default)(this, ConfigParser);
@@ -420,7 +422,18 @@ var ConfigParser = function () {
             var filePathList = ConfigParser.getFilePaths(config);
 
             var _loop = function _loop(file) {
-                if (_fs2.default.existsSync(file) && _fs2.default.lstatSync(file).isFile()) {
+                var match = file.match(FEATURE_FILE_SPEC_REGEX);
+                var filename = void 0;
+                /*
+                 * check whether a file is a feature file specifying a scenario by its line number
+                 * if this is the case extract filename part
+                 */
+                if (match) {
+                    filename = match[1];
+                } else {
+                    filename = file;
+                }
+                if (_fs2.default.existsSync(filename) && _fs2.default.lstatSync(filename).isFile()) {
                     filesToFilter.add(_path2.default.resolve(process.cwd(), file));
                     return 'continue';
                 }
@@ -495,18 +508,27 @@ var ConfigParser = function () {
                 for (var _iterator6 = (0, _getIterator3.default)(patterns), _step6; !(_iteratorNormalCompletion6 = (_step6 = _iterator6.next()).done); _iteratorNormalCompletion6 = true) {
                     var pattern = _step6.value;
 
-                    var filenames = _glob2.default.sync(pattern);
-
-                    filenames = filenames.filter(function (filename) {
-                        return FILE_EXTENSIONS.indexOf(_path2.default.extname(filename)) !== -1;
-                    });
-
-                    filenames = filenames.map(function (filename) {
-                        return _path2.default.isAbsolute(filename) ? _path2.default.normalize(filename) : _path2.default.resolve(process.cwd(), filename);
-                    });
-
-                    if (filenames.length === 0 && !omitWarnings) {
-                        console.warn('pattern', pattern, 'did not match any file');
+                    var filenames = void 0;
+                    /*
+                     * check whether a pattern is a feature file specifying a scenario by its line number
+                     * if this is the case don't glob the pattern
+                    */
+                    if (pattern.match(FEATURE_FILE_SPEC_REGEX)) {
+                        filenames = [_path2.default.isAbsolute(pattern) ? _path2.default.normalize(pattern) : _path2.default.resolve(process.cwd(), pattern)];
+                    } else {
+                        filenames = _glob2.default.sync(pattern);
+
+                        filenames = filenames.filter(function (filename) {
+                            return FILE_EXTENSIONS.indexOf(_path2.default.extname(filename)) !== -1;
+                        });
+
+                        filenames = filenames.map(function (filename) {
+                            return _path2.default.isAbsolute(filename) ? _path2.default.normalize(filename) : _path2.default.resolve(process.cwd(), filename);
+                        });
+
+                        if (filenames.length === 0 && !omitWarnings) {
+                            console.warn('pattern', pattern, 'did not match any file');
+                        }
                     }
 
                     files = (0, _deepmerge2.default)(files, filenames, MERGE_OPTIONS);

package/build/lib/utils/ReporterStats.js

@@ -195,12 +195,18 @@ var ReporterStats = function (_RunnableStats6) {
                 failures: 0
             };
             this.failures = [];
+            this.passes = [];
         }
     }, {
         key: 'getCounts',
         value: function getCounts() {
             return this.counts;
         }
+    }, {
+        key: 'getPasses',
+        value: function getPasses() {
+            return this.passes;
+        }
     }, {
         key: 'getFailures',
         value: function getFailures() {
@@ -414,6 +420,7 @@ var ReporterStats = function (_RunnableStats6) {
         value: function testPass(runner) {
             this.getTestStats(runner).state = 'pass';
             this.counts.passes++;
+            this.passes.push(runner);
         }
     }, {
         key: 'testPending',

package/build/lib/utils/RequestHandler.js

@@ -126,6 +126,8 @@ var RequestHandler = function () {
                 newOptions.qs = this.defaultOptions.queryParams;
             }
 
+            this.defaultOptions.protocol = this.defaultOptions.protocol || 'http';
+
             newOptions.uri = _url2.default.parse(this.defaultOptions.protocol + '://' + (0, _utilities.formatHostname)(this.defaultOptions.hostname) + ':' + this.defaultOptions.port + (requestOptions.gridCommand ? this.gridApiStartPath : this.startPath) + requestOptions.path.replace(':sessionId', this.sessionID || ''));
 
             // send authentication credentials only when creating new session
@@ -277,7 +279,7 @@ var RequestHandler = function () {
                     }
 
                     if (fullRequestOptions.gridCommand) {
-                        if (body.success) {
+                        if (body && body.success) {
                             return resolve({ body, response });
                         }
 
@@ -316,6 +318,16 @@ var RequestHandler = function () {
                         return reject(new _ErrorHandler.RuntimeError(error));
                     }
 
+                    // IEServer webdriver bug where the error is put into the Allow header
+                    // https://github.com/SeleniumHQ/selenium/issues/6828
+                    if (response && response.statusCode === 405) {
+                        var allowHeader = response.headers && response.headers.allow;
+                        var _err = new _ErrorHandler.RuntimeError(allowHeader);
+                        if ((0, _utilities.isUnknownCommand)(_err)) {
+                            return reject(_err);
+                        }
+                    }
+
                     if (retryCount >= totalRetryCount) {
                         var message = 'Couldn\'t connect to selenium server';
                         var status = -1;

package/build/lib/webdriverio.js

@@ -113,7 +113,6 @@ var WebdriverIO = function WebdriverIO(args, modifier) {
      * merge default options with given user options
      */
     var options = (0, _deepmerge2.default)({
-        protocol: 'http',
         waitforTimeout: 1000,
         waitforInterval: 500,
         coloredLogs: true,

package/build/package.json

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

package/docs/guide/getstarted/boilerplate.md

@@ -136,3 +136,29 @@ Boilerplate repo for quick set up of WebdriverIO test scripts with TravisCI, Sau
     - Local notifications
     - ESLint using Semistandard style
     - WebdriverIO tuned Gitignore file
+    
+## [webdriverio/appium-boilerplate](https://github.com/webdriverio/appium-boilerplate/)
+
+Boilerplate project to run Appium tests together with WebdriverIO for:
+
+- iOS/Android Native Apps
+- iOS/Android Hybrid Apps
+- Android Chrome and iOS Safari browser
+
+The boilerplate holds the following things
+- Framework: Jasmine
+- Features:
+    - Configs for:
+        - iOS and Android app
+        - iOS and Android browsers
+    - Helpers for:
+        - WebView
+        - Gestures
+        - Native alerts
+        - Pickers
+     - Tests examples for:
+        - WebView
+        - Login
+        - Forms
+        - Swipe
+        - Browsers

package/docs/guide/testrunner/configurationfile.md

@@ -37,6 +37,12 @@ exports.config = {
     user: 'webdriverio',
     key:  'xxxxxxxxxxxxxxxx-xxxxxx-xxxxx-xxxxxxxxx',
     //
+    // If you run your tests on SauceLabs you can specify the region you want to run your tests
+    // in via the `region` property. You can either provide the full region name or the short handle:
+    // us: us-west-1 (default)
+    // eu: eu-central-1
+    region: 'eu', // for eu-central-1
+    //
     // ==================
     // Specify Test Files
     // ==================
@@ -82,8 +88,8 @@ exports.config = {
         chromeOptions: {
         // to run chrome headless the following flags are required
         // (see https://developers.google.com/web/updates/2017/04/headless-chrome)
-        // args: ['--headless', '--disable-gpu'],       
-        }        
+        // args: ['--headless', '--disable-gpu'],
+        }
     }, {
         // maxInstances can get overwritten per capability. So if you have an in house Selenium
         // grid with only 5 firefox instance available you can make sure that not more than
@@ -142,9 +148,9 @@ exports.config = {
     // Saves a screenshot to a given path if a command fails.
     screenshotPath: 'shots',
     //
-    // Set a base URL in order to shorten url command calls. If your `url` parameter starts 
-    // with `/`, the base url gets prepended, not including the path portion of your baseUrl. 
-    // If your `url` parameter starts without a scheme or `/` (like `some/path`), the base url 
+    // Set a base URL in order to shorten url command calls. If your `url` parameter starts
+    // with `/`, the base url gets prepended, not including the path portion of your baseUrl.
+    // If your `url` parameter starts without a scheme or `/` (like `some/path`), the base url
     // gets prepended directly.
     baseUrl: 'http://localhost:8080',
     //
@@ -257,7 +263,7 @@ exports.config = {
      * @param {Array.<String>} specs List of spec file paths that are to be run
      */
     beforeSession: function (config, capabilities, specs) {
-    },  
+    },
     /**
      * Gets executed before test execution begins. At this point you can access to all global
      * variables like `browser`. It is the perfect place to define custom commands.

package/docs/guide/testrunner/organizesuite.md

@@ -111,6 +111,12 @@ or run multiple specs at once:
 $ wdio wdio.conf.js --spec ./test/specs/signup.js,./test/specs/forgot-password.js
 ```
 
+In case of a feature (Cucumber) you can specify a single scenario by adding a line number:
+
+```sh
+$ wdio wdio.conf.js --spec ./test/specs/login.feature:6
+```
+
 If the spec passed in is not a path to a spec file, it is used as a filter for the spec file names defined in your configuration file. To run all specs with the word 'dialog' in the spec file names, you could use:
 
 ```sh

package/lib/commands/deleteCookie.js

@@ -48,7 +48,7 @@ let deleteCookie = function (name) {
         name = null
     }
 
-    return this.cookie('DELETE', name)
+    return this.cookie('DELETE', typeof name === 'string' ? encodeURIComponent(encodeURIComponent((name))) : name)
 }
 
 export default deleteCookie

package/lib/commands/getCookie.js

@@ -43,7 +43,7 @@ let getCookie = function (name) {
         res.value = res.value || []
 
         if (typeof name === 'string') {
-            return res.value.filter((cookie) => cookie.name === name)[0] || null
+            return res.value.filter((cookie) => cookie.name === encodeURIComponent(encodeURIComponent(name)))[0] || null
         }
 
         return res.value || (typeof name === 'string' ? null : [])

package/lib/commands/leftClick.js

@@ -3,6 +3,8 @@
  * Apply left click on an element. If selector is not provided, click on the last
  * moved-to location.
  *
+ * Uses JSONWireframe buttonPress protocol with W3C actions protocol as fallback.
+ *
  * @alias browser.leftClick
  * @param {String} selector element to click on
  * @param {Number} xoffset  X offset to move to, relative to the top-left corner of the element.

package/lib/commands/middleClick.js

@@ -3,6 +3,8 @@
  * Apply middle click on an element. If selector is not provided, click on the last
  * moved-to location.
  *
+ * Uses JSONWireframe buttonPress protocol with W3C actions protocol as fallback.
+ *
  * @alias browser.middleClick
  * @param {String} selector element to click on
  * @param {Number} xoffset  X offset to move to, relative to the top-left corner of the element.

package/lib/commands/moveToObject.js

@@ -4,53 +4,20 @@
  * offset, the mouse will be moved to the center of the element. If the element is not
  * visible, it will be scrolled into view.
  *
+ * Uses JSONWireframe moveTo protocol with W3C actions protocol fallback.
+ * Uses touchMove protocol for mobile.
+ *
  * @alias browser.moveToObject
  * @param {String} selector element to move to
  * @param {Number} xoffset  X offset to move to, relative to the top-left corner of the element. If not specified, the mouse will move to the middle of the element.
  * @param {Number} yoffset  Y offset to move to, relative to the top-left corner of the element. If not specified, the mouse will move to the middle of the element.
- * @uses protocol/element, protocol/elementIdLocation
+ * @uses protocol/element, protocol/elementIdLocation, protocol/elementIdSize
  * @type action
  *
  */
-
 import { RuntimeError } from '../utils/ErrorHandler'
 
 let moveToObject = function (selector, xoffset, yoffset) {
-    /**
-     * check for offset params
-     */
-    var hasOffsetParams = true
-    if (typeof xoffset !== 'number' && typeof yoffset !== 'number') {
-        hasOffsetParams = false
-    }
-
-    if (this.isMobile) {
-        return this.element(selector).then((res) => {
-            /**
-             * check if element was found and throw error if not
-             */
-            if (!res.value) {
-                throw new RuntimeError(7)
-            }
-
-            return this.elementIdSize(res.value.ELEMENT).then((size) =>
-                this.elementIdLocation(res.value.ELEMENT).then((location) => {
-                    return { size, location }
-                })
-            )
-        }).then((res) => {
-            let x = res.location.value.x + (res.size.value.width / 2)
-            let y = res.location.value.y + (res.size.value.height / 2)
-
-            if (hasOffsetParams) {
-                x = res.location.value.x + xoffset
-                y = res.location.value.y + yoffset
-            }
-
-            return this.touchMove(x, y)
-        })
-    }
-
     return this.element(selector).then((res) => {
         /**
          * check if element was found and throw error if not

package/lib/commands/rightClick.js

@@ -3,6 +3,8 @@
  * Apply right click on an element. If selector is not provided, click on the last
  * moved-to location.
  *
+ * Uses JSONWireframe buttonPress protocol with W3C actions protocol as fallback.
+ *
  * @alias browser.rightClick
  * @param {String} selector element to click on
  * @param {Number} xoffset  X offset to move to, relative to the top-left corner of the element.

package/lib/commands/setCookie.js

@@ -32,14 +32,22 @@
 import { CommandError } from '../utils/ErrorHandler'
 
 let setCookie = function (cookieObj) {
+    const { name } = cookieObj
     /*!
      * parameter check
      */
-    if (typeof cookieObj !== 'object') {
+    if (typeof cookieObj !== 'object' || !name || typeof name !== 'string') {
         throw new CommandError('Please specify a cookie object to set (see https://github.com/SeleniumHQ/selenium/wiki/JsonWireProtocol#cookie-json-object for documentation.')
     }
 
-    return this.cookie('POST', cookieObj)
+    return this.cookie(
+        'POST',
+        Object.assign(
+            {},
+            cookieObj,
+            { name: encodeURIComponent(encodeURIComponent(name)) }
+        )
+    )
 }
 
 export default setCookie

package/lib/protocol/execute.js

@@ -36,7 +36,7 @@
  */
 
 import { ProtocolError } from '../utils/ErrorHandler'
-import { isUnknownCommand } from '../helpers/utilities'
+import { isUnknownCommand, isUnknownError } from '../helpers/utilities'
 
 export default function execute (...args) {
     let script = args.shift()
@@ -59,8 +59,11 @@ export default function execute (...args) {
     return this.requestHandler.create('/session/:sessionId/execute', { script, args }).catch((err) => {
         /**
          * jsonwire command not supported try webdriver endpoint
+         * Note: MicrosoftWebDriver returns "UnknownError" when receiving
+         *  a jsonwire command in W3C Mode
+         *  https://developer.microsoft.com/en-us/microsoft-edge/platform/issues/19917561/
          */
-        if (isUnknownCommand(err)) {
+        if (isUnknownCommand(err) || isUnknownError(err)) {
             return this.requestHandler.create('/session/:sessionId/execute/sync', { script, args })
         }
 

package/lib/protocol/moveTo.js

@@ -19,8 +19,10 @@
  */
 
 import { ProtocolError } from '../utils/ErrorHandler'
+import { isUnknownCommand } from '../helpers/utilities'
 import eventSimulator from '../scripts/eventSimulator'
 import deprecate from '../helpers/deprecationWarning'
+import findMoveToCoordinates from '../helpers/findMoveToCoordinates'
 
 export default function moveTo (element, xoffset, yoffset) {
     let data = {}
@@ -37,6 +39,10 @@ export default function moveTo (element, xoffset, yoffset) {
         data.yoffset = yoffset
     }
 
+    if (this.isMobile) {
+        return findMoveToCoordinates.call(this, element, xoffset, yoffset).then(coordinates => this.touchMove(coordinates.x, coordinates.y))
+    }
+
     /**
      * if no attribute is set, throw error
      */
@@ -67,5 +73,25 @@ export default function moveTo (element, xoffset, yoffset) {
         }, { ELEMENT: element }, target.x, target.y)
     }
 
-    return this.requestHandler.create('/session/:sessionId/moveto', data)
+    return this.requestHandler.create('/session/:sessionId/moveto', data).catch(err => {
+        /**
+         * jsonwire command not supported try w3c protocol endpoint
+         */
+        if (isUnknownCommand(err)) {
+            return findMoveToCoordinates.call(this, element, xoffset, yoffset).then((coordinates) => {
+                return this.actions([{
+                    type: 'pointer',
+                    id: 'mouse',
+                    actions: [{
+                        type: 'pointerMove',
+                        duration: 0,
+                        x: coordinates.x,
+                        y: coordinates.y
+                    }]
+                }])
+            })
+        }
+
+        throw err
+    })
 }

package/package.json

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