条件が「truthy」値に評価されるまで待機します。条件は、評価される値または待機するPromiseを返す任意の関数で指定できます。

オプションの待機時間を指定できます。指定しない場合は、グローバルなwaitForConditionTimeout値が使用されます。

使用方法

                    .waitUntil(conditionFn, [callback])
                
                    .waitUntil(conditionFn, [waitTimeMs], [callback])
                
                    .waitUntil(conditionFn, [waitTimeMs], [retryInterval], [callback])
                
                    .waitUntil(conditionFn, [waitTimeMs], [retryInterval], [message], [callback])
                

describe('waitUntil Example', function() {
  it('demo Test', function(browser) {
    browser
      .url('https://nightwatch.dokyumento.jp)
      .waitUntil(async function() {
        const title = await this.execute(function() {
          return document.title;
        });

        return title === 'Nightwatch.js';
      }, 1000);
  });
}

パラメータ

名前 タイプ 説明
conditionFn 関数

待機する条件。Promiseを返す関数として定義されます。

waitTimeMs
オプション
数値

条件がtrueになるまで待機する時間 (ミリ秒単位)。

retryInterval
オプション
数値

チェック間のインターバル (ミリ秒単位)。

callback
オプション
関数

結果と共に呼び出されるオプションのコールバック関数。

W3C WebDriver仕様