.updateValue() 建議編輯

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

updateValue 等同於 setValue，因為它也會事先清除值。

一個物件映射，其中包含可用的按鍵及其各自的 UTF-8 字元，如 W3C WebDriver 草案規範中所定義，會以 browser.Keys 的形式載入到主要的 Nightwatch 執行個體中。

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]);
};

參數

名稱 類型 描述
using
選用		 字串

要使用的定位策略。請參閱 W3C Webdriver - 定位策略
selector 字串 | 物件

用於定位元素的選擇器 (CSS/Xpath)。可以是字串或物件，其中指定元素屬性。
inputValue 字串 | 陣列

要發送到元素的文字或按鍵。
callback
選用		 函式

選用回呼函式，在命令完成時呼叫。

W3C WebDriver 規範