View Source Improve this doc

waitUntil

This wait command is your universal weapon if you want to wait on something. It expects a condition and waits until that condition is fulfilled with a truthy value. A condition can be either a promise or a command result. The commands within the condition are getting executed synchronously like in your test.

A common example is to wait until a certain element contains a certain text (see example).

Usage

1
browser.waitUntil(condition[,timeout][,timeoutMsg][,interval]);

Parameters

Param Type Details
condition Function/Promise condition to wait on
timeout
optional
Number timeout in ms (default: 500)
timeoutMsg
optional
String error message to throw when waitUntil times out
interval
optional
Number interval between condition checks (default: 500)

Example

example.html
1
2
3
4
5
6
<div id="someText">I am some text</div>
<script>
setTimeout(function() {
$('#someText').html('I am now different');
}, 1000);
</script>
waitUntil.js
1
2
3
4
5
it('should wait until text has changed', function () {
browser.waitUntil(function () {
return browser.getText('#someText') === 'I am now different'
}, 5000, 'expected text to be different after 5s');
});

Uses