「setValue」命令的別名,但會將內容從 nightwatch 日誌中隱藏。

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

一個物件對應表,包含可用的按鍵及其各自的 UTF-8 字元,如 W3C WebDriver 草案規格 中所定義,會載入到主要的 Nightwatch 實例中作為 browser.Keys

setPassword() 命令會自動等待元素出現 (直到指定的逾時時間)。如果找不到元素,則會擲回錯誤,導致測試失敗。您可以將 selector 引數指定為物件,並傳遞 suppressNotFoundErrors = true 選項來抑制找不到元素的錯誤。

如需在 Nightwatch 中使用 DOM 元素的更多資訊,請參閱 尋找與和 DOM 元素互動 指南頁面。

用法

                    .setPassword(selector, inputValue, [callback])
                
                    .setPassword(using, selector, inputValue, [callback])
                

範例

// send some simple text to an input
this.demoTest = function (browser) {
  browser.setPassword('input[type=text]', 'nightwatch');
};

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

參數

名稱 類型 描述
using
選填
字串

要使用的定位策略。請參閱 W3C Webdriver - 定位策略

selector 字串 | 物件

用於定位元素的選擇器 (CSS/Xpath)。可以是字串或指定 元素屬性 的物件。

inputValue 字串 | 陣列

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

callback
選填
函式

命令完成時要呼叫的選填回呼函式。

W3C WebDriver 規格