現在フォーカスされているページ上の要素を取得します。要素はWeb要素 JSONオブジェクトとして返されます。

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

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

このコマンドはプロトコルレベルで動作し、パラメータとしてWeb要素IDを受け入れます。取得するには、.findElement()または.findElements()コマンドを使用します。要素の取得についてもっと読む。

使用方法

module.exports = {
 'demo Test' : function(browser) {
    browser.elementActive(function(result) {
      console.log(result.value)
    });
  }
}

パラメータ

名前 タイプ 説明
callback function

結果値と共に呼び出されるコールバック関数。

W3C WebDriver仕様