Enable global element api to accept element properties as argument.

lib/api/_loaders/element-global.js

@@ -68,6 +68,7 @@ class ElementGlobal {
     this.abortOnFailure = this.settings.globals.abortOnElementLocateError;
     this.timeout = this.settings.globals.waitForConditionTimeout;
     this.retryInterval = this.settings.globals.waitForConditionPollInterval;
+    this.index = 0;
     this.init();
   }
 
@@ -80,14 +81,30 @@ class ElementGlobal {
       return;
     }
 
-    const {locator} = this;
+    let {locator} = this;
     if ((locator instanceof Element) && locator.resolvedElement) {
       this.element = this.createWebElement(locator.resolvedElement);
 
       return;
     }
 
-    this.element = await this.transport.driver.wait(until.elementLocated(locator), this.timeout, null, this.retryInterval);
+    if (locator instanceof Element) {
+      this.setPropertiesFromElement(locator);
+
+      locator = Locator.create(locator);
+    }
+
+    const elements = await this.transport.driver.wait(until.elementsLocated(locator), this.timeout, null, this.retryInterval);
+
+    if (elements.length === 0) {
+      throw new Error(`No element was found for locator: ${locator}`);
+    }
+
+    if (elements.length <= this.index){
+      throw new Error(`Index ${this.index} out of bounds for locator: ${locator}`);
+    }
+
+    this.element = elements[this.index];
   }
 
   static isElementObject(element) {
@@ -111,7 +128,7 @@ class ElementGlobal {
       abortOnFailure, retryInterval, timeout, suppressNotFoundErrors, index
     } = element;
 
-    if (isDefined(index)) {
+    if (isDefined(index) && typeof(index) == 'number') {
       this.index = index;
     }
 
@@ -161,7 +178,7 @@ class ElementGlobal {
         value = {
           value: locator,
           using: this.client.locateStrategy
-        };  
+        };
       } else {
         value = locator;
       }
@@ -267,7 +284,7 @@ class ElementGlobal {
           });
         }
 
-        const lastArg = args[args.length-1];
+        const lastArg = args[args.length - 1];
         if (isFunction(lastArg)) {
           if (error) {
             return lastArg.call(this.api, {

test/apidemos/elements/elementGlobalTest.js

@@ -53,4 +53,11 @@ describe('get text using element-global', function () {
     assert.strictEqual(signupSectionId, '0');
   });
 
+  test('test for element properties as argument', async function () {
+    const weblogin = element({selector: '#weblogin', index: 1});
+    const id = await weblogin.getId();
+
+    assert.strictEqual(id, '3783b042-7001-0740-a2c0-afdaac732e9f');
+  });
+
 });

test/lib/command-mocks.js

@@ -259,14 +259,15 @@ module.exports = {
     return this;
   },
 
-  w3cVisible(value = true) {
+  w3cVisible(value = true, {times = 0} = {}) {
     MockServer.addMock({
       url: '/session/13521-10219-202/execute/sync',
       method: 'POST',
       response: JSON.stringify({
         value
-      })
-    }, true);
+      }),
+      times
+    }, times === 0);
   },
 
   w3cSelected(elementId ='5cc459b8-36a8-3042-8b4a-258883ea642b', value = true) {

test/src/apidemos/elements/testElementGlobal.js

@@ -21,11 +21,20 @@ describe('element global demos', function() {
 
   it('getText on element global instance', function() {
     const testsPath = path.join(__dirname, '../../../apidemos/elements/elementGlobalTest.js');
-    Mocks.elementText();
-    Mocks.tagName('0', 'div');
-    Mocks.visible('0', true, {
+    MockServer.addMock({
+      url: '/session/13521-10219-202/element/5cc459b8-36a8-3042-8b4a-258883ea642b/name',
+      method: 'GET',
+      response: JSON.stringify({
+        value: 'div'
+      })
+    }, true);
+    Mocks.w3cVisible(true, {
       times: 2
     });
+    Mocks.getElementText({
+      elementId: '5cc459b8-36a8-3042-8b4a-258883ea642b',
+      responseText: 'sample text'
+    });
 
     const globals = {
       waitForConditionPollInterval: 50,
@@ -40,6 +49,7 @@ describe('element global demos', function() {
     };
 
     return NightwatchClient.runTests(testsPath, settings({
+      selenium_host: null,
       output: false,
       skip_testcases_on_fail: false,
       globals