@testim/testim-cli
Version:
Command line interface for running Testing on you CI
63 lines (54 loc) • 1.89 kB
JavaScript
/**
*
* Return true if the selected DOM-element found by given selector is visible.
*
* <example>
:index.html
<div id="notDisplayed" style="display: none"></div>
<div id="notVisible" style="visibility: hidden"></div>
<div id="notInViewport" style="position:absolute; left: 9999999"></div>
<div id="zeroOpacity" style="opacity: 0"></div>
:isVisible.js
client
.isVisible('#notDisplayed').then(function(isVisible) {
console.log(isVisible); // outputs: false
})
.isVisible('#notVisible').then(function(isVisible) {
console.log(isVisible); // outputs: false
})
.isVisible('#notExisting').then(function(isVisible) {
console.log(isVisible); // outputs: false
})
.isVisible('#notInViewport').then(function(isVisible) {
console.log(isVisible); // outputs: true!!!
})
.isVisible('#zeroOpacity').then(function(isVisible) {
console.log(isVisible); // outputs: true!!!
});
* </example>
*
* @param {String} selector DOM-element
* @returns {Boolean|Boolean[]} true if element(s)* [is|are] visible
*
* @uses protocol/elements, protocol/elementIdDisplayed
* @type state
*
*/
module.exports = function isVisible (selector) {
return this.elements(selector).then(function(res) {
if(!res.value || res.value.length === 0) {
/**
* if element does not exist it is automatically not visible ;-)
*/
return false;
}
var self = this,
elementIdDisplayedCommands = [];
res.value.forEach(function(elem) {
elementIdDisplayedCommands.push(self.elementIdDisplayed(elem.ELEMENT));
});
return this.unify(elementIdDisplayedCommands, {
extractValue: true
});
});
};