webdriverio-workflo/lib/commands/setValue.js

This is a customized version of webdriverio for use with workflo framework.

/**
 *
 * Send a sequence of key strokes to an element (clears value before). 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>
    :setValue.js
    it('should set value for a certain element', function () {
        var input = $('.input');
        input.setValue('test123');

        // same as
        browser.setValue('.input', 'test123');

        console.log(input.getValue()); // outputs: 'test123'
    });
 * </example>
 *
 * @alias browser.setValue
 * @param {String}              selector   Input element
 * @param {String|Number|Array} values     Input element
 * @uses protocol/elements, protocol/elementIdClear, protocol/elementIdValue
 * @type action
 *
 */

import { CommandError } from '../utils/ErrorHandler'

let setValue = function (selector, value) {
    /*!
     * parameter check
     */
    if (typeof value === 'number') {
        value = value.toString()
    }

    if (typeof value !== 'string' && !Array.isArray(value)) {
        throw new CommandError('number or type of arguments don\'t agree with setValue command')
    }

    return this.elements(selector).then((res) => {
        /**
         * throw NoSuchElement error if no element was found
         */
        if (!res.value || res.value.length === 0) {
            throw new CommandError(7, selector || this.lastResult.selector)
        }

        let elementIdValueCommands = []
        for (let elem of res.value) {
            elementIdValueCommands.push(this.elementIdClear(elem.ELEMENT).elementIdValue(elem.ELEMENT, value))
        }

        return this.unify(elementIdValueCommands)
    })
}

export default setValue