.updateValue() 建议编辑
向元素发送一些文本。可用于设置表单元素的值或向元素发送一系列按键。可以指定任何 UTF-8 字符。
updateValue 等同于 setValue,因为它也会事先清除值。
包含可用键及其在 W3C WebDriver 草案规范 中定义的相应 UTF-8 字符的对象映射加载到主 Nightwatch 实例上,作为 browser.Keys
。
命令 updateValue()
将自动等待元素出现(直到指定超时)。如果未找到元素,则会抛出错误,导致测试失败。可以通过将 selector
参数指定为对象并传递 suppressNotFoundErrors = true
选项来抑制未找到元素的错误。
用法
.updateValue(selector, inputValue, [callback])
示例
// send some simple text to an input
this.demoTest = function (browser) {
browser.updateValue('input[type=text]', 'nightwatch');
};
// send some text to an input and hit enter.
this.demoTest = function (browser) {
browser.updateValue('input[type=text]', ['nightwatch', browser.Keys.ENTER]);
};
参数
名称 | 类型 | 描述 |
---|---|---|
使用 可选 |
字符串 | 要使用的定位器策略。参见 W3C Webdriver - 定位器策略 |
选择器 |
字符串 | 对象 | 用于定位元素的选择器(CSS/Xpath)。可以是字符串,也可以是指定 元素属性 的对象。 |
inputValue |
字符串 | 数组 | 要发送到元素的文本或按键。 |
回调 可选 |
函数 | 命令完成后要调用的可选回调函数。 |