Add global app property.

lib/index.js

@@ -359,6 +359,20 @@ Object.defineProperty(Nightwatch, 'browser', {
   }
 });
 
+Object.defineProperty(Nightwatch, 'app', {
+  configurable: true,
+  get() {
+    if (global.browser) {
+      return global.browser;
+    }
+
+    const err = new TypeError('Nightwatch client is not yet available.');
+    err.addDetailedErr = true;
+
+    throw err;
+  }
+});
+
 Object.defineProperty(Nightwatch, 'Key', {
   configurable: true,
   get() {

lib/testsuite/index.js

@@ -260,6 +260,13 @@ class TestSuite {
       return null;
     }
 
+    Object.defineProperty(global, 'app', {
+      configurable: true,
+      get: function() {
+        return global.browser;
+      }
+    });
+
     Object.defineProperty(global, 'by', {
       configurable: true,
       get: function() {

test/apidemos/appium/appiumTest.js

@@ -0,0 +1,33 @@
+const assert = require('assert');
+
+describe('appium api demo', function () {
+  after((app) => app.end());
+
+  const availableAppiumCommands = [
+    'startActivity',
+    'getCurrentActivity',
+    'getCurrentPackage',
+    'getOrientation',
+    'setOrientation',
+    'getGeolocation',
+    'setGeolocation',
+    'pressKeyCode',
+    'longPressKeyCode',
+    'hideKeyboard',
+    'isKeyboardShown',
+    'getContexts',
+    'getContext',
+    'setContext'
+  ];
+
+  it('test chrome available API commands', async function () {
+    // app variable is available globally
+    // eslint-disable-next-line
+    assert.strictEqual(app !== undefined, true);
+
+    availableAppiumCommands.forEach((command) => {
+      // eslint-disable-next-line
+      assert.strictEqual(typeof app.appium[command], 'function');
+    });
+  });
+});

test/src/apidemos/appium/testAppiumAPI.js

@@ -0,0 +1,66 @@
+const {strictEqual} = require('assert');
+const path = require('path');
+const common = require('../../../common.js');
+const MockServer = require('../../../lib/mockserver.js');
+const NightwatchClient = common.require('index.js');
+
+describe('appium api demos', function () {
+  beforeEach(function (done) {
+    this.server = MockServer.init(undefined, {port: 4723});
+    this.server.on('listening', () => {
+      done();
+    });
+  });
+
+  afterEach(function (done) {
+    this.server.close(function () {
+      done();
+    });
+  });
+
+  it('run appium api demo tests basic', function () {
+    const testsPath = path.join(__dirname, '../../../apidemos/appium/appiumTest.js');
+
+    const globals = {
+      waitForConditionPollInterval: 50,
+
+      reporter(results) {
+        if (results.lastError) {
+          throw results.lastError;
+        }
+      }
+    };
+
+    MockServer.addMock({
+      url: '/wd/hub/session',
+      method: 'POST',
+      response: JSON.stringify({
+        value: {
+          sessionId: '1352110219202',
+          version: 'TEST',
+          platform: 'TEST'
+        }
+      })
+    });
+
+    return NightwatchClient.runTests(testsPath, {
+      selenium: {
+        host: 'localhost',
+        port: 4723,
+        start_process: false,
+        use_appium: true
+      },
+      desiredCapabilities: {
+        browserName: ''
+      },
+      output: false,
+      skip_testcases_on_fail: false,
+      silent: true,
+      persist_globals: true,
+      globals,
+      output_folder: false
+    }).then(_ => {
+      strictEqual(NightwatchClient.app !== undefined, true);
+    });
+  });
+});