/** * * 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). * * :example.html
I am some text
:waitUntil.js 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'); }); *
* * * @alias browser.waitUntil * @param {Function|Promise} condition condition to wait on * @param {Number=} timeout timeout in ms (default: 500) * @param {String=} timeoutMsg error message to throw when waitUntil times out * @param {Number=} interval interval between condition checks (default: 500) * @uses utility/pause * @type utility * */ import { WaitUntilTimeoutError } from '../utils/ErrorHandler' import Timer from '../utils/Timer' export default function (condition, timeout, timeoutMsg, interval) { /*! * ensure that timeout and interval are set properly */ if (typeof timeout !== 'number') { timeout = this.options.waitforTimeout } if (typeof interval !== 'number') { interval = this.options.waitforInterval } let fn if (typeof condition === 'function') { fn = condition.bind(this) } else { fn = () => Promise.resolve(condition) } let isSync = this.options.sync let timer = new Timer(interval, timeout, fn, true, isSync) return timer.catch((e) => { if (e.message === 'timeout' && typeof timeoutMsg === 'string') { throw new WaitUntilTimeoutError(timeoutMsg) } if (e.type === 'NoSuchElement') { throw new WaitUntilTimeoutError(e.message) } throw new WaitUntilTimeoutError(`Promise was rejected with the following reason: ${e.message}`) }) }