要素にテキストを送信します。フォーム要素の値を設定したり、要素に一連のキーストロークを送信するために使用できます。任意のUTF-8文字を指定できます。

updateValue は、事前に値をクリアする点でもsetValue と同等です。

W3C WebDriver ドラフト仕様で定義されている、使用可能なキーとその対応するUTF-8文字を持つオブジェクトマップが、メインのNightwatchインスタンスにbrowser.Keysとしてロードされます。

コマンド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]);
};

パラメータ

名前 説明
使用
オプション
文字列

使用するロケーター戦略。W3C Webdriver - ロケーター戦略を参照してください。

selector 文字列 | オブジェクト

要素の特定に使用されるセレクター(CSS/XPath)。文字列、または要素のプロパティを指定するオブジェクトのいずれかです。

inputValue 文字列 | 配列

要素に送信するテキストまたはキーストローク。

callback
オプション
関数

コマンドが完了したときに呼び出されるオプションのコールバック関数。

W3C WebDriver仕様