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

setValue 还会通过预先调用 clear() 来清除元素的现有值。

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

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

用法

                    browser.element(selector).setValue(inputValue)
                

示例

// send some simple text to an input
this.demoTest = function (browser) {
  const result = await browser.element('input[type=text]').setValue('nightwatch');
};

// send some text to an input and hit enter.
this.demoTest = function (browser) {
  const result = await browser.element('input[type=text]').setValue(['nightwatch', browser.Keys.ENTER]);
};

参数

名称 类型 描述
inputValue string | array

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

callback
可选
function

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

W3C WebDriver 规范