.updateValue() 編集を提案する
要素にテキストを送信します。フォーム要素の値を設定したり、要素に一連のキーストロークを送信するために使用できます。任意のUTF-8文字を指定できます。
updateValue は、事前に値をクリアする点でもsetValue と同等です。
W3C WebDriver ドラフト仕様で定義されている、使用可能なキーとその対応するUTF-8文字を持つオブジェクトマップが、メインのNightwatchインスタンスにbrowser.Keys
としてロードされます。
コマンドupdateValue()
は、要素が存在するのを自動的に待ちます(指定されたタイムアウトまで)。要素が見つからない場合、エラーが発生し、テストが失敗します。selector
引数をオブジェクトとして指定し、suppressNotFoundErrors = true
オプションを渡すことで、要素が見つからないエラーを抑制できます。
使用方法
.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 オプション |
関数 | コマンドが完了したときに呼び出されるオプションのコールバック関数。 |