textarea またはテキスト入力要素の値をクリアします。

コマンド clearValue() は、要素が存在するまで (指定されたタイムアウトまで) 自動的に待機します。要素が見つからない場合はエラーがスローされ、テストが失敗します。selector 引数をオブジェクトとして指定し、suppressNotFoundErrors = true オプションを渡すことで、要素が見つからないエラーを抑制できます。

Nightwatch での DOM 要素の操作の詳細については、「DOM 要素の検索と操作」ガイドページを参照してください。

使用法

                    browser.clearValue('<SELECTOR>', function (result) { }])
                
                    // using global element()
browser.clearValue(element('<SELECTOR>'))
                

module.exports = {
  demoTest(browser) {
    browser.clearValue('#login input[type=text]');

    browser.clearValue('#login input[type=text]', function(result) {
      console.log('clearValue result', result);
    });

    // with explicit locate strategy
    browser.clearValue('css selector', '#login input[type=text]');

    // with selector object - see https://nightwatch.dokyumento.jp/guide/writing-tests/finding-interacting-with-dom-elements.html#postdoc-element-properties
    browser.clearValue({
      selector: '#login input[type=text]',
      index: 1,
      suppressNotFoundErrors: true
    });

    browser.clearValue({
      selector: '#login input[type=text]',
      timeout: 2000 // overwrite the default timeout (in ms) to check if the element is present
    });
  }
}

パラメータ

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

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

selector 文字列 | オブジェクト

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

callback
オプション
関数

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

W3C WebDriver 仕様