Added isVisible Missing Command (Fixes #4037)

lib/api/web-element/commands/isVisible.js

@@ -0,0 +1,30 @@
+/**
+ * Returns the visible text for the element.
+ *
+ * For more info on working with DOM elements in Nightwatch, refer to the <a href="https://nightwatchjs.org/guide/writing-tests/finding-interacting-with-dom-elements.html">Finding & interacting with DOM Elements</a> guide page.
+ *
+ * @example
+ * export default {
+ *   demoTest(browser: NightwatchAPI): void {
+ *     const result = browser.element('#main ul li a.first').isVisible();
+ *       .assert.valueEquals('custom text');
+ *   },
+ *
+ *   async demoTestAsync(browser: NightwatchAPI): Promise<void> {
+ *     const result = await browser.element('#main ul li a.first').isVisible();
+ *     console.log('element text:', result);
+ *   }
+ * }
+ *
+ * @since 3.0.0
+ * @method isVisible
+ * @memberof ScopedWebElement
+ * @instance
+ * @syntax browser.element(selector).isVisible()
+ * @see https://www.w3.org/TR/webdriver#dfn-get-element-text
+ * @returns {ScopedValue<string>}
+ * @alias isDisplayed
+ */
+module.exports.command = function() {
+  return this.runQueuedCommandScoped('isVisibleElement');
+};

lib/transport/selenium-webdriver/method-mappings.js

@@ -546,7 +546,12 @@ module.exports = class MethodMappings {
 
           return elementText;
         },
+        async isVisibleElement(id) {
+          const element = await this.getWebElement(id);
+          const elementVisible = await element.isDisplayed();
 
+          return elementVisible;
+        },
         // the value param is compulsory
         async getElementValue(webElementOrId, value) {
           const element = this.getWebElement(webElementOrId);

types/tests/webElement.test-d.ts

@@ -137,6 +137,8 @@ describe('new element() api', function () {
     expectType<ElementValue<string>>(elem.getTagName());
     expectType<ElementValue<string>>(elem.getText());
 
+    expectType<ElementValue<boolean>>(elem.isVisible());
+
     expectType<ElementValue<string | null>>(elem.getProperty('property-name'));
     expectType<ElementValue<string | null>>(elem.getAttribute('attrib-name'));
     expectType<ElementValue<string | null>>(elem.getValue());

types/web-element.d.ts

@@ -143,6 +143,8 @@ export interface ScopedElement extends Element, PromiseLike<WebElement> {
 
   getText(): ElementValue<string>;
 
+  isVisible() : ElementValue<boolean>;
+
   click(): Promise<WebElement>;
 
   clear(): Promise<WebElement>;