webdriverio 5.11.11 → 5.11.12

package/build/commands/element/addValue.js

@@ -7,37 +7,10 @@ exports.default = addValue;
 
 var _utils = require("../../utils");
 
-/**
- *
- * Add a value to an object found by given selector. You can also use unicode
- * characters like Left arrow or Back space. WebdriverIO will take care of
- * translating them into unicode characters. You’ll find all supported characters
- * [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.
- *
- * <example>
-    :addValue.js
-    it('should demonstrate the addValue command', () => {
-        let input = $('.input')
-        input.addValue('test')
-        input.addValue(123)
-
-        value = input.getValue()
-        assert(value === 'test123') // true
-    })
- * </example>
- *
- * @alias element.addValue
- * @param {string | number | boolean | object | Array<any>}      value     value to be added
- * @uses protocol/elements, protocol/elementIdValue
- * @type action
- *
- */
 function addValue(value) {
   if (!this.isW3C) {
     return this.elementSendKeys(this.elementId, (0, _utils.transformToCharString)(value));
-  } // Workaround https://github.com/appium/appium/issues/12085
-
+  }
 
   if (this.isMobile) {
     return this.elementSendKeys(this.elementId, (0, _utils.transformToCharString)(value).join(''), (0, _utils.transformToCharString)(value));

package/build/commands/element/clearValue.js

@@ -5,32 +5,6 @@ Object.defineProperty(exports, "__esModule", {
 });
 exports.default = clearValue;
 
-/**
- *
- * Clear a `<textarea>` or text `<input>` element’s value. Make sure you can interact with the
- * element before using this command. You can't clear an input element that is disabled or in
- * readonly mode.
- *
- * <example>
-    :clearValue.js
-    it('should demonstrate the clearValue command', function () {
-        const elem = $('.input')
-        elem.setValue('test123')
-
-        const value = elem.getValue()
-        console.log(value) // returns 'test123'
-
-        elem.clearValue()
-        value = elem.getValue()
-        assert(value === ''); // true
-    })
- * </example>
- *
- * @alias element.clearValue
- * @uses protocol/elements, protocol/elementIdClear
- * @type action
- *
- */
 function clearValue() {
   return this.elementClear(this.elementId);
 }

package/build/commands/element/click.js

@@ -5,49 +5,6 @@ Object.defineProperty(exports, "__esModule", {
 });
 exports.default = click;
 
-/**
- *
- * Click on an element.
- *
- * Note: This issues a Webdriver `click` command for the selected element, which generally scrolls to and then clicks the
- * selected element. However, if you have fixed-position elements (such as a fixed header or footer) that cover up the
- * selected element after it is scrolled within the viewport, the click will be issued at the given coordinates, but will
- * be received by your fixed (overlaying) element. In these cased the following error is thrown:
- *
- * ```
- * Element is not clickable at point (x, x). Other element would receive the click: ..."
- * ```
- *
- * To work around this, try to find the overlaying element and remove it via `execute` command so it doesn't interfere
- * the click. You also can try to scroll to the element yourself using `scroll` with an offset appropriate for your
- * scenario.
- *
- * <example>
-    :example.html
-    <button id="myButton" onclick="document.getElementById('someText').innerHTML='I was clicked'">Click me</button>
-    <div id="someText">I was not clicked</div>
-    :click.js
-    it('should demonstrate the click command', () => {
-        const myButton = $('#myButton')
-        myButton.click()
-        const myText = $('#someText')
-        const text = myText.getText();
-        assert(text === 'I was clicked'); // true
-    })
-    :example.js
-    it('should fetch menu links and visit each page', () => {
-        const links = $$('#menu a');
-        links.forEach((link) => {
-            link.click();
-        });
-    });
- * </example>
- *
- * @alias element.click
- * @uses protocol/element, protocol/elementIdClick
- * @type action
- *
- */
 function click() {
   return this.elementClick(this.elementId);
 }

package/build/commands/element/doubleClick.js

@@ -5,41 +5,11 @@ Object.defineProperty(exports, "__esModule", {
 });
 exports.default = doubleClick;
 
-/**
- *
- * Double-click on an element.
- *
- * <example>
-    :example.html
-    <button id="myButton" ondblclick="document.getElementById('someText').innerHTML='I was dblclicked'">Click me</button>
-    <div id="someText">I was not clicked</div>
-    :doubleClick.js
-    it('should demonstrate the doubleClick command', () => {
-        const myButton = $('#myButton')
-        myButton.doubleClick()
-
-        const value = myButton.getText()
-        assert(value === 'I was dblclicked') // true
-    })
- * </example>
- *
- * @alias element.doubleClick
- * @uses protocol/element, protocol/moveTo, protocol/doDoubleClick, protocol/touchDoubleClick
- * @type action
- *
- */
 async function doubleClick() {
-  /**
-   * move to element
-   */
   if (!this.isW3C) {
     await this.moveTo();
     return this.positionDoubleClick();
   }
-  /**
-   * W3C way of handle the double click actions
-   */
-
 
   await this.performActions([{
     type: 'pointer',

package/build/commands/element/dragAndDrop.js

@@ -7,17 +7,6 @@ exports.default = dragAndDrop;
 
 var _utils = require("../../utils");
 
-/**
- *
- * Drag an item to a destination element.
- *
- * @alias element.dragAndDrop
- * @param {Element} target    destination selector
- * @param {Number=}  duration  how long the drag should take place
- * @uses action/moveToObject, protocol/buttonDown, protocol/buttonUp, property/getLocation, protocol/touchDown, protocol/touchMove, protocol/touchUp
- * @type action
- *
- */
 const ACTION_BUTTON = 0;
 
 async function dragAndDrop(target, duration = 100) {
@@ -31,10 +20,6 @@ async function dragAndDrop(target, duration = 100) {
     await target.moveTo();
     return this.buttonUp(ACTION_BUTTON);
   }
-  /**
-   * get coordinates to drag and drop
-   */
-
 
   const sourceRect = await (0, _utils.getElementRect)(this);
   const targetRect = await (0, _utils.getElementRect)(target);
@@ -42,10 +27,6 @@ async function dragAndDrop(target, duration = 100) {
   const sourceY = parseInt(sourceRect.y + sourceRect.height / 2, 10);
   const targetX = parseInt(targetRect.x + targetRect.width / 2, 10) - sourceX;
   const targetY = parseInt(targetRect.y + targetRect.height / 2, 10) - sourceY;
-  /**
-   * W3C way of handle the drag and drop action
-   */
-
   return this.performActions([{
     type: 'pointer',
     id: 'finger1',
@@ -63,8 +44,7 @@ async function dragAndDrop(target, duration = 100) {
     }, {
       type: 'pause',
       duration: 10
-    }, // emulate human pause
-    {
+    }, {
       type: 'pointerMove',
       duration,
       origin: 'pointer',

package/build/commands/element/getAttribute.js

@@ -5,32 +5,6 @@ Object.defineProperty(exports, "__esModule", {
 });
 exports.default = getAttribute;
 
-/**
- *
- * Get an attribute from a DOM-element based on the attribute name.
- *
- * <example>
-    :index.html
-    <form action="/submit" method="post" class="loginForm">
-        <input type="text" name="name" placeholder="username"></input>
-        <input type="text" name="password" placeholder="password"></input>
-        <input type="submit" name="submit" value="submit"></input>
-    </form>
-    :getAttribute.js
-    it('should demonstrate the getAttribute command', () => {
-        const form = $('form')
-        const attr = form.getAttribute('method')
-        console.log(attr) // outputs: "post"
-    })
- * </example>
- *
- * @alias element.getAttribute
- * @param {String} attributeName requested attribute
- * @return {String|null} The value of the attribute, or null if it is not set on the element.
- * @uses protocol/elements, protocol/elementIdAttribute
- * @type property
- *
- */
 function getAttribute(attributeName) {
   return this.getElementAttribute(this.elementId, attributeName);
 }

package/build/commands/element/getCSSProperty.js

@@ -7,72 +7,6 @@ exports.default = getCSSProperty;
 
 var _utils = require("../../utils");
 
-/**
- *
- * Get a css property from a DOM-element selected by given selector. The return value
- * is formatted to be testable. Colors gets parsed via [rgb2hex](https://www.npmjs.org/package/rgb2hex)
- * and all other properties get parsed via [css-value](https://www.npmjs.org/package/css-value).
- *
- * Note that shorthand CSS properties (e.g. background, font, border, margin, padding, list-style, outline,
- * pause, cue) are not returned, in accordance with the DOM CSS2 specification - you should directly access
- * the longhand properties (e.g. background-color) to access the desired values.
- *
- * <example>
-    :example.html
-    <label id="myLabel" for="input" style="color: #0088cc; font-family: helvetica, arial, freesans, clean, sans-serif, width: 100px">Some Label</label>
-    :getCSSProperty.js
-    it('should demonstrate the getCSSProperty command', () => {
-        const elem = $('#myLabel')
-        const color = elem.getCSSProperty('color')
-        console.log(color)
-        // outputs the following:
-        // {
-        //     property: 'color',
-        //     value: 'rgba(0, 136, 204, 1)',
-        //     parsed: {
-        //         hex: '#0088cc',
-        //         alpha: 1,
-        //         type: 'color',
-        //         rgba: 'rgba(0, 136, 204, 1)'
-        //     }
-        // }
-
-        const font = elem.getCSSProperty('font-family')
-        console.log(font)
-        // outputs the following:
-        // {
-        //      property: 'font-family',
-        //      value: 'helvetica',
-        //      parsed: {
-        //          value: [ 'helvetica', 'arial', 'freesans', 'clean', 'sans-serif' ],
-        //          type: 'font',
-        //          string: 'helvetica, arial, freesans, clean, sans-serif'
-        //      }
-        // }
-
-        var width = elem.getCSSProperty('width')
-        console.log(width)
-        // outputs the following:
-        // {
-        //     property: 'width',
-        //     value: '100px',
-        //     parsed: {
-        //         type: 'number',
-        //         string: '100px',
-        //         unit: 'px',
-        //         value: 100
-        //     }
-        // }
-    })
- * </example>
- *
- * @alias element.getCSSProperty
- * @param {String} cssProperty css property name
- * @return {Object} The specified css of the element
- * @uses protocol/elements, protocol/elementIdCssProperty
- * @type property
- *
- */
 async function getCSSProperty(cssProperty) {
   const cssValue = await this.getElementCSSValue(this.elementId, cssProperty);
   return (0, _utils.parseCSS)(cssValue, cssProperty);

package/build/commands/element/getHTML.js

@@ -13,41 +13,9 @@ var _getHTML = _interopRequireDefault(require("../../scripts/getHTML"));
 
 function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
 
-/**
- *
- * Get source code of specified DOM element by selector.
- *
- * <example>
-    :index.html
-    <div id="test">
-        <span>Lorem ipsum dolor amet</span>
-    </div>
-    :getHTML.js
-    it('should get html for certain elements', () => {
-        var outerHTML = $('#test').getHTML();
-        console.log(outerHTML);
-        // outputs:
-        // "<div id="test"><span>Lorem ipsum dolor amet</span></div>"
-
-        var innerHTML = $('#test').getHTML(false);
-        console.log(innerHTML);
-        // outputs:
-        // "<span>Lorem ipsum dolor amet</span>"
-    });
- * </example>
- *
- * @alias element.getHTML
- * @param {Boolean=} includeSelectorTag if true it includes the selector element tag (default: true)
- * @return {String}  the HTML of the specified element
- * @uses action/selectorExecute
- * @type property
- *
- */
 function getHTML(includeSelectorTag = true) {
   return (0, _utils.getBrowserObject)(this).execute(_getHTML.default, {
     [_constants.ELEMENT_KEY]: this.elementId,
-    // w3c compatible
-    ELEMENT: this.elementId // jsonwp compatible
-
+    ELEMENT: this.elementId
   }, includeSelectorTag);
 }

package/build/commands/element/getLocation.js

@@ -7,33 +7,6 @@ exports.default = getLocation;
 
 var _utils = require("../../utils");
 
-/**
- *
- * Determine an element’s location on the page. The point (0, 0) refers to
- * the upper-left corner of the page.
- *
- * <example>
-    :getLocation.js
-    it('should demonstrate the getLocation function', () => {
-        browser.url('http://github.com');
-        const logo = $('.octicon-mark-github')
-        const location = logo.getLocation();
-        console.log(location); // outputs: { x: 150, y: 20 }
-
-        const xLocation = logo.getLocation('x')
-        console.log(xLocation); // outputs: 150
-
-        const yLocation = logo.getLocation('.octicon-mark-github', 'y')
-        console.log(yLocation); // outputs: 20
-    });
- * </example>
- *
- * @alias element.getLocation
- * @param {String} prop    can be "x" or "y" to get a result value directly for easier assertions
- * @return {Object|Number}  The X and Y coordinates for the element on the page (`{x:number, y:number}`)
- * @uses protocol/elementIdLocation
- * @type property
- */
 async function getLocation(prop) {
   let location = {};
 

package/build/commands/element/getProperty.js

@@ -11,22 +11,6 @@ var _getProperty = _interopRequireDefault(require("../../scripts/getProperty"));
 
 function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
 
-/**
- * The Get Element Property command will return the result of getting a property of an element.
- *
- * <example>
-    :getProperty.js
-    it('should demonstrate the getCSSProperty command', () => {
-        var elem = $('body')
-        var color = elem.getProperty('tagName')
-        console.log(color) // outputs: "BODY"
-    })
- * </example>
- *
- * @alias element.getProperty
- * @param {String} property  name of the element property
- * @return {Object|String} the value of the property of the selected element
- */
 function getProperty(property) {
   if (this.isW3C) {
     return this.getElementProperty(this.elementId, property);

package/build/commands/element/getSize.js

@@ -7,33 +7,6 @@ exports.default = getSize;
 
 var _utils = require("../../utils");
 
-/**
- *
- * Get the width and height for an DOM-element.
- *
- * <example>
-    :getSize.js
-    it('should demonstrate the getSize command', () => {
-        browser.url('http://github.com')
-        const logo = $('.octicon-mark-github')
-
-        const size = logo.getSize()
-        console.log(size) // outputs: { width: 32, height: 32 }
-
-        const width = logo.getSize('width')
-        console.log(width) // outputs: 32
-
-        const height = logo.getSize('height')
-        console.log(height) // outputs: 32
-    })
- * </example>
- *
- * @alias element.getElementSize
- * @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
- * @type property
- *
- */
 async function getSize(prop = null) {
   let rect = {};
 

package/build/commands/element/getTagName.js

@@ -5,29 +5,6 @@ Object.defineProperty(exports, "__esModule", {
 });
 exports.default = getTagName;
 
-/**
- *
- * Get tag name of a DOM-element.
- *
- * <example>
-    :index.html
-    <div id="elem">Lorem ipsum</div>
-
-    :getTagName.js
-    it('should demonstrate the getTagName command', () => {
-        const elem = $('#elem');
-
-        const tagName = elem.getTagName();
-        console.log(tagName); // outputs: "div"
-    })
- * </example>
- *
- * @alias element.getTagName
- * @return {String} the element's tag name, as a lowercase string
- * @uses protocol/elements, protocol/elementIdName
- * @type property
- *
- */
 function getTagName() {
   return this.getElementTagName(this.elementId);
 }

package/build/commands/element/getText.js

@@ -5,46 +5,6 @@ Object.defineProperty(exports, "__esModule", {
 });
 exports.default = getText;
 
-/**
- *
- * Get the text content from a DOM-element. Make sure the element
- * you want to request the text from [is interactable](http://www.w3.org/TR/webdriver/#interactable)
- * otherwise you will get an empty string as return value. If the element is disabled or not
- * visible and you still want to receive the text content use [getHTML](https://webdriver.io/docs/api/element/getHTML.html)
- * as a workaround.
- *
- * <example>
-    :index.html
-    <div id="elem">
-        Lorem ipsum <strong>dolor</strong> sit amet,<br>
-        consetetur sadipscing elitr
-    </div>
-    <span style="display: none">I am invisible</span>
-    :getText.js
-    it('should demonstrate the getText function', () => {
-        const elem = $('#elem');
-        console.log(elem.getText());
-        // outputs the following:
-        // "Lorem ipsum dolor sit amet,consetetur sadipscing elitr"
-
-        const span = $('span');
-        console.log(span.getText());
-        // outputs "" (empty string) since element is not interactable
-    });
-    it('get content from table cell', () => {
-        browser.url('http://the-internet.herokuapp.com/tables');
-        const rows = $$('#table1 tr');
-        const columns = rows[1].$$('td'); // get columns of 2nd row
-        console.log(columns[2].getText()); // get text of 3rd column
-    });
- * </example>
- *
- * @alias element.getText
- * @return {String} content of selected element (all HTML tags are removed)
- * @uses protocol/elements, protocol/elementIdText
- * @type property
- *
- */
 function getText() {
   return this.getElementText(this.elementId);
 }

package/build/commands/element/getValue.js

@@ -5,31 +5,7 @@ Object.defineProperty(exports, "__esModule", {
 });
 exports.default = getValue;
 
-/**
- *
- * Get the value of a `<textarea>`, `<select>` or text `<input>` found by given selector.
- * If multiple elements are found via the given selector, an array of values is returned instead.
- * For input with checkbox or radio type use isSelected.
- *
- * <example>
-    :index.html
-    <input type="text" value="John Doe" id="username">
-    :getValue.js
-    it('should demonstrate the getValue command', () => {
-        const inputUser = $('#username');
-        const value = inputUser.getValue();
-        console.log(value); // outputs: "John Doe"
-    });
- * </example>
- *
- * @alias element.getValue
- * @return {String}  requested element(s) value
- * @uses protocol/elements, protocol/elementIdProperty
- * @type property
- *
- */
 function getValue() {
-  // `!this.isMobile` added to workaround https://github.com/appium/appium/issues/12218
   if (this.isW3C && !this.isMobile) {
     return this.getElementProperty(this.elementId, 'value');
   }

package/build/commands/element/isDisplayed.js

@@ -13,82 +13,21 @@ var _isElementDisplayed = _interopRequireDefault(require("../../scripts/isElemen
 
 function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
 
-/**
- *
- * Return true if the selected DOM-element is displayed.
- *
- * <example>
-    :index.html
-    <div id="notDisplayed" style="display: none"></div>
-    <div id="notVisible" style="visibility: hidden"></div>
-    <div id="notInViewport" style="position:absolute; left: 9999999"></div>
-    <div id="zeroOpacity" style="opacity: 0"></div>
-    :isDisplayed.js
-    it('should detect if an element is displayed', () => {
-        let elem = $('#notDisplayed');
-        let isDisplayed = elem.isDisplayed();
-        console.log(isDisplayed); // outputs: false
-
-        elem = $('#notVisible');
-
-        isDisplayed = elem.isDisplayed();
-        console.log(isDisplayed); // outputs: false
-
-        elem = $('#notExisting');
-        isDisplayed = elem.isDisplayed();
-        console.log(isDisplayed); // outputs: false
-
-        elem = $('#notInViewport');
-        isDisplayed = elem.isDisplayed();
-        console.log(isDisplayed); // outputs: true
-
-        elem = $('#zeroOpacity');
-        isDisplayed = elem.isDisplayed();
-        console.log(isDisplayed); // outputs: true
-    });
- * </example>
- *
- * @alias element.isDisplayed
- * @return {Boolean} true if element is displayed
- * @uses protocol/elements, protocol/elementIdDisplayed
- * @type state
- *
- */
 const noW3CEndpoint = ['microsoftedge', 'safari', 'chrome'];
 
 async function isDisplayed() {
   let browser = (0, _utils.getBrowserObject)(this);
-  /*
-   * This is only necessary as isDisplayed is on the exclusion list for the middleware
-   */
 
   if (!this.elementId) {
     this.elementId = (await this.parent.$(this.selector)).elementId;
   }
-  /*
-   * if element was still not found it also is not displayed
-   */
-
 
   if (!this.elementId) {
     return false;
   }
-  /*
-   * https://www.w3.org/TR/webdriver/#element-displayedness
-   * Certain drivers have decided to remove the endpoint as the spec
-   * no longer dictates it. In those instances, we pass the element through a script
-   * that was provided by Brian Burg of safaridriver.
-   *
-   * 6th of May 2019 APPIUM response (mykola-mokhnach) :
-   * - Appium didn't enable W3C mode for mobile drivers.
-   * - Safari and Chrome work in jsonwp mode and Appium just rewrites W3C requests from upstream to jsonwp if needed
-   */
-
 
   return browser.isW3C && !browser.isMobile && noW3CEndpoint.includes(browser.capabilities.browserName.toLowerCase()) ? await browser.execute(_isElementDisplayed.default, {
     [_constants.ELEMENT_KEY]: this.elementId,
-    // w3c compatible
-    ELEMENT: this.elementId // jsonwp compatible
-
+    ELEMENT: this.elementId
   }) : await this.isElementDisplayed(this.elementId);
 }