1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
1
1
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
 
 
 
 
1
 
1
 
 
 
1
 
 
 
 
1
 
 
 
 
 
 
 
 
 
 
1
 
 
var util = require('util');
var WaitForElementPresent = require('./waitForElementPresent.js');
 
/**
 * Waits a given time in milliseconds for an element to be visible in the page before performing any other commands or assertions.
 *
 * If the element fails to be present and visible in the specified amount of time, the test fails. You can change this by setting `abortOnFailure` to `false`.
 *
 * You can change the polling interval by defining a `waitForConditionPollInterval` property (in milliseconds) in as a global property in your `nightwatch.json` or in your external globals file.
 *
 * Similarly, a default timeout can be specified as a global `waitForConditionTimeout` property (in milliseconds).
 *
 * ```
 * this.demoTest = function (browser) {
 *   browser.waitForElementVisible('body', 1000);
 *   // continue if failed
 *   browser.waitForElementVisible('body', 1000, false);
 *   // with callback
 *   browser.waitForElementVisible('body', 1000, function() {
 *     // do something while we're here
 *   });
 *   // custom Spanish message
 *   browser.waitForElementVisible('body', 1000, 'elemento %s no era visible en %d ms');
 *   // many combinations possible - the message is always the last argument
 *   browser.waitForElementVisible('body', 1000, false, function() {}, 'elemento %s no era visible en %d ms');
 * };
 * ```
 *
 * @method waitForElementVisible
 * @param {string} selector The selector (CSS / Xpath) used to locate the element.
 * @param {number} time The number of milliseconds to wait. The runner performs repeated checks every 500 ms.
 * @param {boolean} [abortOnFailure] By the default if the element is not found the test will fail. Set this to false if you wish for the test to continue even if the assertion fails. To set this globally you can define a property `abortOnAssertionFailure` in your globals.
 * @param {function} [callback] Optional callback function to be called when the command finishes.
 * @param {string} [message] Optional message to be shown in the output; the message supports two placeholders: %s for current selector and %d for the time (e.g. Element %s was not in the page for %d ms).
 * @api commands
 */
function WaitForElementVisible() {
  WaitForElementPresent.call(this);
  this.expectedValue = 'visible';
}
 
util.inherits(WaitForElementVisible, WaitForElementPresent);
 
WaitForElementVisible.prototype.elementFound = function(result, now) {
  return this.isVisible();
};
 
WaitForElementVisible.prototype.elementVisible = function(result, now) {
  var defaultMsg = 'Element <%s> was visible after %d milliseconds.';
  return this.pass(result, defaultMsg, now - this.startTimer);
};
 
WaitForElementVisible.prototype.elementNotVisible = function(result, now) {
  if (now - this.startTimer < this.ms) {
    // element wasn't visible, schedule another check
    this.reschedule('isVisible');
    return this;
  }
 
  var defaultMsg = 'Timed out while waiting for element <%s> to be visible for %d milliseconds.';
  return this.fail(result, 'not visible', this.expectedValue, defaultMsg);
};
 
module.exports = WaitForElementVisible;