feat: support getGeoLocation (requires 'Always' in Location Services)

lib/commands/location.js

@@ -4,6 +4,43 @@ import log from '../logger';
 
 let commands = {};
 
+/**
+ * @typedef {Object} LocationObject
+ *
+ * @property {number} latitude - The latitude of the device under test
+ * @property {number} longitude - The lognitude of the device under test
+ * @property {number} altitude - Always 0 since iOS does not return altitude as the Location Service
+ */
+
+/**
+ * Returns location of the device under test.
+ * The device under test must allow the location services for WDA
+ * as 'Always' to get the location data correctly.
+ *
+ * The 'latitude' and 'longitude' could be zero even the location services
+ * is 'Always' since it needs a time to uptodate the location data.
+ *
+ * @returns {LocationObject}
+ * @throws {Error} If the device under test returns an error message.
+ *                 i.e.: tvOS returns unsupported error
+ */
+commands.getGeoLocation = async function getGeoLocation () {
+  const {
+    authorizationStatus,
+    latitude,
+    longitude
+  } = await this.proxyCommand('/wda/device/location', 'GET');
+
+  // '3' is 'Always' in the privacy
+  // https://developer.apple.com/documentation/corelocation/clauthorizationstatus
+  if (authorizationStatus !== 3) {
+    log.errorAndThrow(`Location service must be 'Always'. Please set it up manually via ` +
+      `'Settings > Privacy > Location Services -> WebDriverAgentRunner-Runner'`);
+  }
+
+  return {latitude, longitude, altitude: 0};
+};
+
 commands.setGeoLocation = async function setGeoLocation (location) {
   let {latitude, longitude} = location;
 

package.json

@@ -51,7 +51,7 @@
     "appium-ios-simulator": "^3.25.1",
     "appium-remote-debugger": "^8.13.2",
     "appium-support": "^2.47.1",
-    "appium-webdriveragent": "^2.32.2",
+    "appium-webdriveragent": "^2.33.0",
     "appium-xcode": "^3.8.0",
     "async-lock": "^1.0.0",
     "asyncbox": "^2.3.1",

test/functional/basic/basic-e2e-specs.js

@@ -261,6 +261,13 @@ describe('XCUITestDriver - basics -', function () {
     });
   });
 
+  describe('get geo location -', function () {
+    it('should fail because of preference error', async function () {
+      await driver.getGeoLocation('30.0001', '21.0002')
+        .should.eventually.be.rejectedWith('Location service must be');
+    });
+  });
+
   describe('geo location -', function () {
     it('should work on Simulator', async function () {
       if (process.env.CI || process.env.REAL_DEVICE) {

test/unit/commands/location-specs.js

@@ -12,6 +12,30 @@ describe('location commands', function () {
     proxySpy.reset();
   });
 
+  describe('getGeoLocation', function () {
+    it('should be authorizationStatus !== 3', async function () {
+      proxySpy.withArgs(
+        '/wda/device/location',
+        'GET').returns({authorizationStatus: 0, latitude: 0, longitude: 0});
+
+      await driver.getGeoLocation({})
+        .should.eventually.be.rejectedWith('Location service must be');
+    });
+
+    it('should be authorizationStatus === 3', async function () {
+      proxySpy.withArgs(
+        '/wda/device/location',
+        'GET').returns({authorizationStatus: 3, latitude: -100, longitude: 100});
+
+      await driver.getGeoLocation({})
+        .should.eventually.eql({
+          altitude: 0,
+          latitude: -100,
+          longitude: 100
+        });
+    });
+  });
+
   describe('setLocation', function () {
     let startSimulateLocationServiceStub;
     let setLocationStub;