清除文本区域或文本输入元素的值。

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

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

用法

                    browser.clearValue('<SELECTOR>', function (result) { }])
                
                    // using global element()
browser.clearValue(element('<SELECTOR>'))
                

示例

module.exports = {
  demoTest(browser) {
    browser.clearValue('#login input[type=text]');

    browser.clearValue('#login input[type=text]', function(result) {
      console.log('clearValue result', result);
    });

    // with explicit locate strategy
    browser.clearValue('css selector', '#login input[type=text]');

    // with selector object - see https://nightwatch.node.org.cn/guide/writing-tests/finding-interacting-with-dom-elements.html#postdoc-element-properties
    browser.clearValue({
      selector: '#login input[type=text]',
      index: 1,
      suppressNotFoundErrors: true
    });

    browser.clearValue({
      selector: '#login input[type=text]',
      timeout: 2000 // overwrite the default timeout (in ms) to check if the element is present
    });
  }
}

参数

名称 类型 描述
使用
可选
字符串

要使用的定位器策略。请参阅 W3C Webdriver - 定位器策略

selector 字符串 | 对象

用于定位元素的选择器(CSS/Xpath)。可以是字符串或对象,该对象指定 元素属性

callback
可选
函数

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

W3C WebDriver 规范