Add support for tapAtPoint action

detox/ios/Detox/MethodInvocation.m

@@ -65,6 +65,14 @@ + (id) getValue:(id)value withType:(id)type onError:(void (^)(NSString*))onError
         CGFloat v = [value doubleValue];
         return [NSNumber numberWithDouble:v];
     }
+	if ([type isEqualToString:@"CGPoint"])
+	{
+		if (![value isKindOfClass:[NSDictionary class]]) return nil;
+		NSDictionary *v = (NSDictionary*)value;
+		CGFloat x = [[v objectForKey:@"x"] floatValue];
+		CGFloat y = [[v objectForKey:@"y"] floatValue];
+		return [NSValue valueWithCGPoint:CGPointMake(x, y)];
+	}
     if ([type isEqualToString:@"CGRect"])
     {
         if (![value isKindOfClass:[NSDictionary class]]) return nil;

detox/src/ios/expect.js

@@ -49,6 +49,13 @@ class TapAction extends Action {
   }
 }
 
+class TapAtPointAction extends Action {
+    constructor(value) {
+        super();
+        this._call = invoke.call(invoke.IOS.Class('GREYActions'), 'actionForTapAtPoint:', invoke.IOS.CGPoint(value));
+    }
+}
+
 class LongPressAction extends Action {
   constructor() {
     super();
@@ -254,6 +261,9 @@ class Element {
   async tap() {
     return await new ActionInteraction(this, new TapAction()).execute();
   }
+  async tapAtPoint(value) {
+    return await new ActionInteraction(this, new TapAtPointAction(value)).execute();
+  }
   async longPress() {
     return await new ActionInteraction(this, new LongPressAction()).execute();
   }

detox/src/ios/expect.test.js

@@ -96,6 +96,7 @@ describe('expect', async () => {
 
   it(`interactions`, async () => {
     await e.element(e.by.label('Tap Me')).tap();
+    await e.element(e.by.label('Tap Me')).tapAtPoint({x: 10, y:10});
     await e.element(e.by.label('Tap Me')).longPress();
     await e.element(e.by.id('UniqueId819')).multiTap(3);
     await e.element(e.by.id('UniqueId937')).typeText('passcode');

detox/test/e2e/c-actions.js

@@ -22,6 +22,11 @@ describe('Actions', () => {
     await expect(element(by.id('UniqueId819'))).toHaveLabel('Taps: 3');
   });
 
+  it('should tap on an element at point', async () => {
+    await element(by.id('View7990')).tapAtPoint({x:180, y:140});
+    await expect(element(by.id('UniqueId819'))).toHaveLabel('Taps: 1');
+  });
+
   // Backspace is supported by using "\b" in the string. Return key is supported with "\n"
   it('should type in an element', async () => {
     await element(by.id('UniqueId937')).tap();

detox/test/src/Screens/ActionsScreen.js

@@ -24,7 +24,7 @@ export default class ActionsScreen extends Component {
   render() {
     if (this.state.greeting) return this.renderAfterButton();
     return (
-      <View style={{ flex: 1, paddingTop: 40, justifyContent: 'flex-start' }}>
+      <View testID='View7990' style={{ flex: 1, paddingTop: 40, justifyContent: 'flex-start' }}>
 
         <TouchableOpacity onPress={this.onButtonPress.bind(this, 'Tap Working')}
           onLongPress={this.onButtonPress.bind(this, 'Long Press Working')}

docs/APIRef.ActionsOnElement.md

@@ -11,6 +11,7 @@ Actions are functions that emulate user behavior. They are being performed on ma
 - [`.tap()`](#tap)
 - [`.longPress()`](#longpress)
 - [`.multiTap()`](#multitaptimes)
+- [`.tapAtPoint()`](#tapatpoint)
 - [`.typeText()`](#typetexttext)
 - [`.replaceText()`](#replacetexttext)
 - [`.clearText()`](#cleartext)
@@ -39,6 +40,13 @@ Simulate multiple taps on an element.
 ```js
 await element(by.id('tappable')).multiTap(3);
 ```
+### `tapAtPoint()`
+Simulate tap at a specific point on an element.<br><br>
+Note: The point coordinates are relative to the matched element and the element size could changes on different devices or even when changing the device font size.   
+
+```js
+await element(by.id('tappable')).tapAtPoint({x:5, y:10});
+```
 
 ### `typeText(text)`
 Use the builtin keyboard to type text into a text field.