.waitUntil() Suggest edits
Since: 2.0.0Waits for a condition to evaluate to a "truthy" value. The condition may be specified by any function which
returns the value to be evaluated or a Promise to wait for.
An optional wait time can be specified, otherwise the global waitForConditionTimeout value will be used.
Usage
.waitUntil(conditionFn, [callback]).waitUntil(conditionFn, [waitTimeMs], [callback]).waitUntil(conditionFn, [waitTimeMs], [retryInterval], [callback]).waitUntil(conditionFn, [waitTimeMs], [retryInterval], [message], [callback])Parameters
| Name | Type | description |
|---|---|---|
conditionFn |
function | The condition to wait on, defined as function which returns a Promise |
waitTimeMsOptional |
number | How long to wait for the condition to be true (in milliseconds). |
retryIntervalOptional |
number | The interval to use between checks (in milliseconds). |
callbackOptional |
Function | An optional callback which will be called with the result |
Example
describe('waitUntil Example', function() {
it('demo Test', function(browser) {
browser
.url('https://nightwatchjs.org)
.waitUntil(async function() {
const title = await this.execute(function() {
return document.title;
});
return title === 'Nightwatch.js';
}, 1000);
});
}