var util = require('util'); var WaitForElement = require('./_waitForElement.js'); /** * Opposite of `waitForElementPresent`. Waits a given time in milliseconds for an element to be not present (i.e. removed) in the page before performing any other commands or assertions. * * If the element is still present after the specified amount of time, the test fails. * * 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.waitForElementNotPresent('#dialog', 1000); * }; * ``` * * @method waitForElementNotPresent * @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). * @see waitForElementPresent * @since v0.4.0 * @api commands */ function WaitForElementNotPresent() { WaitForElement.call(this); this.expectedValue = 'not found'; } util.inherits(WaitForElementNotPresent, WaitForElement); WaitForElementNotPresent.prototype.elementFound = function(result, now) { if (now - this.startTimer < this.ms) { // element is still there, schedule another check this.reschedule(); return this; } var defaultMsg = 'Timed out while waiting for element <%s> to be removed for %d milliseconds.'; return this.fail(result, 'found', this.expectedValue, defaultMsg); }; WaitForElementNotPresent.prototype.elementNotFound = function(result, now) { var defaultMsg = 'Element <%s> was not present after %d milliseconds.'; return this.pass(result, defaultMsg, now - this.startTimer); }; module.exports = WaitForElementNotPresent;