將文字傳送到元素。可用於設定表單元素的值,或將一連串的按鍵傳送到元素。可以指定任何 UTF-8 字元。

setValue 也會先呼叫 clear() 來清除元素的現有值。

根據 W3C WebDriver 草案規格 定義,包含可用按鍵及其對應 UTF-8 字元的物件映射表,會以 browser.Keys 的形式載入到主要的 Nightwatch 實例中。

如需更多關於在 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 字串 | 陣列

要傳送到元素的文字或按鍵。

callback
選用
函式

可選的回呼函式,在命令完成時呼叫。

W3C WebDriver 規格