向元素发送一些文本。可用于设置表单元素的值或向元素发送一系列按键。可以指定任何 UTF-8 字符。

updateValue 等同于 setValue,因为它也会事先清除值。

包含可用键及其在 W3C WebDriver 草案规范 中定义的相应 UTF-8 字符的对象映射加载到主 Nightwatch 实例上,作为 browser.Keys

命令 updateValue() 将自动等待元素出现(直到指定超时)。如果未找到元素,则会抛出错误,导致测试失败。可以通过将 selector 参数指定为对象并传递 suppressNotFoundErrors = true 选项来抑制未找到元素的错误。

有关在 Nightwatch 中使用 DOM 元素的更多信息,请参考 查找和交互 DOM 元素 指南页面。

用法

                    .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 字符串 | 数组

要发送到元素的文本或按键。

回调
可选
函数

命令完成后要调用的可选回调函数。

W3C WebDriver 规范