Added missing isVisible command in new Element API

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

@@ -0,0 +1,33 @@
+/**
+ * Determines if an element is visible.
+ *
+ * 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
+ * describe('isVisible Demo', function() {
+ *
+ *   it('test isVisible', function(browser) {
+ *     browser.element('#search')
+ *       .isVisible()
+ *       .assert.equals(true);
+ *   });
+ *
+ *   it('test async isVisible', async function(browser) {
+ *     const result = await browser.element('#search').isVisible();
+ *     browser.assert.equal(result, true)
+ *   });
+ *
+ *   after(browser => browser.end());
+ * });
+ *
+ * @since 3.0.0
+ * @method isVisible
+ * @memberof ScopedWebElement
+ * @instance
+ * @syntax browser.element(selector).isVisible()
+ * @see https://www.w3.org/TR/webdriver/#element-displayedness
+ * @returns {ScopedValue<boolean>}
+ */
+module.exports.command = function () {
+  return this.runQueuedCommandScoped('isElementDisplayed');
+};

test/src/api/commands/web-element/testIsVisible.js

@@ -0,0 +1,41 @@
+const assert = require('assert');
+const MockServer  = require('../../../../lib/mockserver.js');
+const CommandGlobals = require('../../../../lib/globals/commands.js');
+
+describe('element().isVisible() command', function() {
+  before(function (done) {
+    CommandGlobals.beforeEach.call(this, done);
+  });
+
+  after(function(done) {
+    CommandGlobals.afterEach.call(this, done);
+  });
+
+  it('test .element().isVisible()', function() {
+    MockServer.addMock({
+      url: '/wd/hub/session/1352110219202/element/0/visible',
+      method: 'GET',
+      response: JSON.stringify({
+        value: true
+      })
+    });
+
+    this.client.api.element('#search').isVisible(function (result) {
+      this.assert.equal(result.value, true);
+    });
+  });
+
+  it('async test .element().isVisible()', async function() {
+    MockServer.addMock({
+      url: '/wd/hub/session/1352110219202/element/0/visible',
+      method: 'GET',
+      response: JSON.stringify({
+        value: true
+      })
+    });
+
+    const resultPromise = this.client.api.element('#search').isVisible();
+    const result = await resultPromise;
+    assert.equal(result, null);
+  });
+});

types/tests/webElement.test-d.ts

@@ -140,6 +140,7 @@ describe('new element() api', function () {
     expectType<ElementValue<string | null>>(elem.getProperty('property-name'));
     expectType<ElementValue<string | null>>(elem.getAttribute('attrib-name'));
     expectType<ElementValue<string | null>>(elem.getValue());
+    expectType<ElementValue<boolean>>(elem.isVisible());
 
     expectType<ElementValue<ScopedElementRect>>(elem.getRect());
     expectType<ElementValue<ScopedElementRect>>(elem.getSize());

types/web-element.d.ts

@@ -188,6 +188,8 @@ export interface ScopedElement extends Element, PromiseLike<WebElement> {
   rightClick(): Promise<WebElement>;
 
   waitUntil(signalOrOptions: WaitUntilActions | WaitUntilOptions, waitOptions?: WaitUntilOptions): Promise<WebElement>;
+
+  isVisible(): ElementValue<boolean>;
 }
 
 type WaitUntilOptions = {