detox 20.27.7-smoke.0 → 20.31.0

package/android/rninfo.gradle

@@ -1,11 +1,24 @@
 import groovy.json.JsonSlurper
 
-def getRNVersion = { workingDir ->
-    println("RNInfo: workingDir=$workingDir")
+def getRNPackageJsonDir() {
+    def currentDir = rootDir
+    while (currentDir != null) {
+        def nodeModulesDir = new File(currentDir, "node_modules/react-native")
+        def file = new File(nodeModulesDir, 'package.json')
+        if (file.exists()) {
+            return file.path
+        }
+        currentDir = currentDir.parentFile
+    }
+    throw new GradleException("Unable to find module: $moduleName")
+}
+
+def getRNVersion = { rnPackageJsonPath ->
+    println("RNInfo: package.json=$rnPackageJsonPath")
     def jsonSlurper = new JsonSlurper()
-    def packageFile = "$workingDir/../node_modules/react-native/package.json"
-    println("RNInfo: reading $packageFile")
-    Map<String, Object> packageJSON  = jsonSlurper.parse(new File(packageFile))
+    def packageFile =
+    println("RNInfo: reading $rnPackageJsonPath")
+    Map<String, Object> packageJSON  = jsonSlurper.parse(new File(rnPackageJsonPath))
     String rnVersion = packageJSON.get('version')
     return rnVersion
 }
@@ -15,24 +28,18 @@ def getMajorVersionInternal = { semanticVersion ->
     return rnVersionMajor
 }
 
-ext.getRnMajorVersion = { workingDir ->
-    String rnVersion = getRNVersion(workingDir)
-    Integer rnVersionMajor = getMajorVersionInternal(rnVersion)
-    return rnVersionMajor
-}
-
-def rnVersion = getRNVersion(rootDir)
+def rnVersion = getRNVersion(getRNPackageJsonDir())
 def rnMajorVer = getMajorVersionInternal(rnVersion)
-if (hasProperty('project')) {
-    println "[$project] RNInfo: detected React Native version: $rnVersion (major=$rnMajorVer)"
+println "RNInfo: detected React Native version: $rnVersion (major=$rnMajorVer)"
 
-    project.ext.rnInfo = [
-        version       : rnVersion,
-        majorVersion  : rnMajorVer,
-        isRN69OrHigher: rnMajorVer >= 69,
-        isRN70OrHigher: rnMajorVer >= 70,
-        isRN71OrHigher: rnMajorVer >= 71,
-        isRN72OrHigher: rnMajorVer >= 72,
-        isRN73OrHigher: rnMajorVer >= 73,
-    ]
-}
+ext.rnInfo = [
+    version       : rnVersion,
+    majorVersion  : rnMajorVer,
+    isRN69OrHigher: rnMajorVer >= 69,
+    isRN70OrHigher: rnMajorVer >= 70,
+    isRN71OrHigher: rnMajorVer >= 71,
+    isRN72OrHigher: rnMajorVer >= 72,
+    isRN73OrHigher: rnMajorVer >= 73,
+    isRN74OrHigher: rnMajorVer >= 74,
+    isRN75OrHigher: rnMajorVer >= 75,
+]

package/android/settings.gradle

@@ -1,14 +1,19 @@
+// RN75+_BLOCK_START
+pluginManagement { includeBuild("../node_modules/@react-native/gradle-plugin") }
+plugins { id("com.facebook.react.settings") }
+extensions.configure(com.facebook.react.ReactSettingsExtension){ ex -> ex.autolinkLibrariesFromCommand() }
+// RN75+_BLOCK_END
+
+
 apply from: '../android/rninfo.gradle'
 include ':detox'
 
 println("RNInfo: rootDir=$rootDir")
+println "[settings] RNInfo: detected React Native version: (major=${ext.rnInfo.version})"
 
-def rnMajorVer = getRnMajorVersion(rootDir)
-println "[settings] RNInfo: detected React Native version: (major=$rnMajorVer)"
 
-if (rnMajorVer < 72) {
-    includeBuild('../node_modules/react-native-gradle-plugin')
-} else {
+if (ext.rnInfo.isRN72OrHigher) {
     includeBuild('../node_modules/@react-native/gradle-plugin')
+} else {
+    includeBuild('../node_modules/react-native-gradle-plugin')
 }
-

package/detox.d.ts

@@ -784,6 +784,45 @@ declare global {
              */
             setOrientation(orientation: Orientation): Promise<void>;
 
+            /**
+             * Perform a tap at arbitrary coordinates on the device's screen.
+             * @param point Coordinates in the element's coordinate space. Optional. defaults: x: 100, y: 100
+             * @param shouldIgnoreStatusBar Coordinates will be measured starting from under the status bar. this param will affect only in Android tests. Optional. default: true
+             * @example await device.tap();
+             * @example await device.tap({ x: 100, y: 150 }, false);
+             * @example await device.tap({ x: 100, y: 150 });
+             * @example await device.tap(false);
+             */
+            tap(): Promise<void>;
+            tap(point: Point2D): Promise<void>;
+            tap(point: Point2D, shouldIgnoreStatusBar: boolean): Promise<void>;
+            tap(shouldIgnoreStatusBar: boolean): Promise<void>;
+
+            /**
+             * Perform a long press at arbitrary coordinates on the device's screen. Custom press duration if needed.
+             * @param point Coordinates in the device's coordinate space. Optional. defaults: x: 100, y: 100
+             * @param duration Custom press duration time, in milliseconds. Optional (defaults to the standard long-press duration for Android and 1000 milliseconds for ios).
+             *      Custom durations should be used cautiously, as they can affect test consistency and user experience expectations.
+             *      They are typically necessary when testing components that behave differently from the platform's defaults or when simulating unique user interactions.
+             * @param shouldIgnoreStatusBar Coordinates will be measured starting from under the status bar. this param will affect only in Android tests. Optional. default: true
+             * @example await device.longPress();
+             * @example await device.longPress({ x: 100, y: 150 }, 2000, false);
+             * @example await device.longPress({ x: 100, y: 150 }, 2000);
+             * @example await device.longPress(2000, false);
+             * @example await device.longPress({ x: 100, y: 150 }, false);
+             * @example await device.longPress({ x: 100, y: 150 });
+             * @example await device.longPress(2000);
+             * @example await device.longPress(false);
+             */
+            longPress(): Promise<void>;
+            longPress(point: Point2D, duration: number, shouldIgnoreStatusBar: boolean): Promise<void>;
+            longPress(point: Point2D, duration: number): Promise<void>;
+            longPress(duration: number, shouldIgnoreStatusBar: boolean): Promise<void>;
+            longPress(point: Point2D, shouldIgnoreStatusBar: boolean): Promise<void>;
+            longPress(point: Point2D): Promise<void>;
+            longPress(duration: number): Promise<void>;
+            longPress(shouldIgnoreStatusBar: boolean): Promise<void>;
+
             /**
              * Sets the simulator/emulator location to the given latitude and longitude.
              *

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "detox",
   "description": "E2E tests and automation for mobile",
-  "version": "20.27.7-smoke.0",
+  "version": "20.31.0",
   "bin": {
     "detox": "local-cli/cli.js"
   },
@@ -34,10 +34,13 @@
     "postinstall": "node scripts/postinstall.js"
   },
   "devDependencies": {
-    "@react-native/babel-preset": "0.73.19",
-    "@react-native/eslint-config": "^0.73.2",
-    "@react-native/metro-config": "^0.73.3",
-    "@react-native/typescript-config": "0.73.1",
+    "@react-native-community/cli": "15.0.1",
+    "@react-native-community/cli-platform-android": "15.0.1",
+    "@react-native-community/cli-platform-ios": "15.0.1",
+    "@react-native/babel-preset": "0.76.3",
+    "@react-native/eslint-config": "0.76.3",
+    "@react-native/metro-config": "0.76.3",
+    "@react-native/typescript-config": "0.76.3",
     "@tsconfig/react-native": "^3.0.0",
     "@types/bunyan": "^1.8.8",
     "@types/child-process-promise": "^2.2.1",
@@ -59,7 +62,7 @@
     "jest-allure2-reporter": "^2.0.0-beta.18",
     "metro-react-native-babel-preset": "0.76.8",
     "prettier": "^3.1.1",
-    "react-native": "0.73.2",
+    "react-native": "0.76.3",
     "react-native-codegen": "^0.0.8",
     "typescript": "^5.3.3",
     "wtfnode": "^0.9.1"
@@ -71,7 +74,7 @@
     "caf": "^15.0.1",
     "chalk": "^4.0.0",
     "child-process-promise": "^2.2.0",
-    "detox-copilot": "^0.0.23",
+    "detox-copilot": "^0.0.27",
     "execa": "^5.1.1",
     "find-up": "^5.0.0",
     "fs-extra": "^11.0.0",
@@ -116,5 +119,5 @@
   "browserslist": [
     "node 14"
   ],
-  "gitHead": "339b51c8b014686628fff6f695b3d79ccf555a12"
+  "gitHead": "89a3f0efbac69cd37db886a53f712d51db8f857d"
 }

package/scripts/postinstall.js

@@ -1,6 +1,6 @@
 const { platform, env } = process;
 
-const { setGradleVersionByRNVersion } = require('./updateGradle');
+const { patchGradleByRNVersion } = require('./updateGradle');
 
 const isDarwin = platform === 'darwin';
 const shouldInstallDetox = !env.DETOX_DISABLE_POSTINSTALL;
@@ -12,4 +12,4 @@ if (isDarwin && shouldInstallDetox) {
   execFileSync(`${__dirname}/build_local_xcuitest.ios.sh`, { stdio: 'inherit' });
 }
 
-setGradleVersionByRNVersion();
+patchGradleByRNVersion();

package/scripts/updateGradle.js

@@ -6,6 +6,12 @@ const rnMinor = require('../src/utils/rn-consts/rn-consts').rnVersion.minor;
 function getGradleVersionByRNVersion() {
   switch (rnMinor) {
     default:
+      return '8.10.2';
+    case '75':
+      return '8.8';
+    case '74':
+      return '8.6';
+    case '73':
       return '8.3';
     case '72':
       return '8.0';
@@ -17,19 +23,46 @@ function getGradleVersionByRNVersion() {
 /**
  * Update the Gradle wrapper to the version that matches the React Native version.
  */
-function setGradleVersionByRNVersion() {
-  const gradleVersion = getGradleVersionByRNVersion();
-  updateGradleWrapperSync(gradleVersion);
+function patchGradleByRNVersion() {
+  updateGradleWrapperSync();
+  patchSettingsGradle();
+}
+
+/**
+ * In RN75 and above the settings.gradle file should contain the following lines. We can't wrap them in 'if' statement
+ * because they should be the first line in the settings file. This patch could be safely removed after dropping support
+ * for RN74.
+ */
+function patchSettingsGradle() {
+  if (parseInt(rnMinor) >= 75) {
+    return;
+  }
+
+  const settingsGradlePath = path.join(process.cwd(), 'android', 'settings.gradle');
+  console.log(`Patching settings.gradle. File: ${settingsGradlePath}`);
+
+  try {
+    let data = fs.readFileSync(settingsGradlePath, 'utf8');
+    const blockRegex = /\/\/ RN75\+_BLOCK_START[\s\S]*?\/\/ RN75\+_BLOCK_END/g;
+
+    // Replace the block with an empty string
+    const updatedData = data.replace(blockRegex, '');
+
+    fs.writeFileSync(settingsGradlePath, updatedData, 'utf8');
+    console.log('settings.gradle patched successfully.');
+  } catch (err) {
+    console.error('Error:', err);
+  }
 }
 
 /**
  * Update the Gradle wrapper to the specified version.
- *
- * @param {string} newVersion - the new Gradle wrapper version
  */
-function updateGradleWrapperSync(newVersion) {
+function updateGradleWrapperSync() {
+  const newVersion = getGradleVersionByRNVersion();
+
   const gradleWrapperPath = path.join(process.cwd(), 'android', 'gradle', 'wrapper', 'gradle-wrapper.properties');
-  console.log(`Updating Gradle wrapper to version${newVersion}. File: ${gradleWrapperPath}`);
+  console.log(`Updating Gradle wrapper to version$ {newVersion}. File: ${gradleWrapperPath}`);
 
   try {
     let data = fs.readFileSync(gradleWrapperPath, 'utf8');
@@ -43,5 +76,5 @@ function updateGradleWrapperSync(newVersion) {
 }
 
 module.exports = {
-  setGradleVersionByRNVersion
+  patchGradleByRNVersion: patchGradleByRNVersion
 };

package/src/DetoxWorker.js

@@ -1,4 +1,5 @@
 const CAF = require('caf');
+const copilot = require('detox-copilot').default;
 const _ = require('lodash');
 
 const Client = require('./client/Client');
@@ -62,7 +63,7 @@ class DetoxWorker {
     /** @type {Detox.SystemFacade} */
     this.system = null;
     /** @type {Detox.DetoxCopilotFacade} */
-    this.copilot = null;
+    this.copilot = new DetoxCopilot();
 
     this._deviceCookie = null;
 
@@ -126,8 +127,6 @@ class DetoxWorker {
       runtimeDeviceFactory,
     } = environmentFactory.createFactories(deviceConfig);
 
-    this.copilot = new DetoxCopilot();
-
     const envValidator = envValidatorFactory.createValidator();
     yield envValidator.validate();
 
@@ -226,9 +225,10 @@ class DetoxWorker {
     yield this._artifactsManager.onRunDescribeStart(...args);
   };
 
-  onTestStart = function* (_signal, testSummary) {
-    // Copilot is reset before each test to ensure a clean state
-    this.copilot.resetIfNeeded();
+  onTestStart = function* (_signal, testSummary){
+    if (copilot.isInitialized()) {
+      copilot.start();
+    }
 
     this._validateTestSummary('beforeEach', testSummary);
 
@@ -257,6 +257,11 @@ class DetoxWorker {
       pendingRequests: testSummary.timedOut,
       testName: testSummary.fullName,
     });
+
+    if (copilot.isInitialized()) {
+      // In case of failure, pass false to copilot, so temporary cache is not saved
+      copilot.end(testSummary.status === 'passed');
+    }
   };
 
   onRunDescribeFinish = function* (_signal, ...args) {

package/src/android/espressoapi/EspressoDetox.js

@@ -73,6 +73,89 @@ class EspressoDetox {
     };
   }
 
+  static tap(x, y, shouldIgnoreStatusBar) {
+    if (typeof x !== "number") throw new Error("x should be a number, but got " + (x + (" (" + (typeof x + ")"))));
+    if (typeof y !== "number") throw new Error("y should be a number, but got " + (y + (" (" + (typeof y + ")"))));
+    if (typeof shouldIgnoreStatusBar !== "boolean") throw new Error("shouldIgnoreStatusBar should be a boolean, but got " + (shouldIgnoreStatusBar + (" (" + (typeof shouldIgnoreStatusBar + ")"))));
+    return {
+      target: {
+        type: "Class",
+        value: "com.wix.detox.espresso.EspressoDetox"
+      },
+      method: "tap",
+      args: [{
+        type: "Integer",
+        value: x
+      }, {
+        type: "Integer",
+        value: y
+      }, {
+        type: "boolean",
+        value: shouldIgnoreStatusBar
+      }]
+    };
+  }
+
+  static longPress(x, y, shouldIgnoreStatusBar) {
+    function longPress3(x, y, shouldIgnoreStatusBar) {
+      if (typeof x !== "number") throw new Error("x should be a number, but got " + (x + (" (" + (typeof x + ")"))));
+      if (typeof y !== "number") throw new Error("y should be a number, but got " + (y + (" (" + (typeof y + ")"))));
+      if (typeof shouldIgnoreStatusBar !== "boolean") throw new Error("shouldIgnoreStatusBar should be a boolean, but got " + (shouldIgnoreStatusBar + (" (" + (typeof shouldIgnoreStatusBar + ")"))));
+      return {
+        target: {
+          type: "Class",
+          value: "com.wix.detox.espresso.EspressoDetox"
+        },
+        method: "longPress",
+        args: [{
+          type: "Integer",
+          value: x
+        }, {
+          type: "Integer",
+          value: y
+        }, {
+          type: "boolean",
+          value: shouldIgnoreStatusBar
+        }]
+      };
+    }
+
+    function longPress4(x, y, duration, shouldIgnoreStatusBar) {
+      if (typeof x !== "number") throw new Error("x should be a number, but got " + (x + (" (" + (typeof x + ")"))));
+      if (typeof y !== "number") throw new Error("y should be a number, but got " + (y + (" (" + (typeof y + ")"))));
+      if (typeof duration !== "number") throw new Error("duration should be a number, but got " + (duration + (" (" + (typeof duration + ")"))));
+      if (typeof shouldIgnoreStatusBar !== "boolean") throw new Error("shouldIgnoreStatusBar should be a boolean, but got " + (shouldIgnoreStatusBar + (" (" + (typeof shouldIgnoreStatusBar + ")"))));
+      return {
+        target: {
+          type: "Class",
+          value: "com.wix.detox.espresso.EspressoDetox"
+        },
+        method: "longPress",
+        args: [{
+          type: "Integer",
+          value: x
+        }, {
+          type: "Integer",
+          value: y
+        }, {
+          type: "Integer",
+          value: duration
+        }, {
+          type: "boolean",
+          value: shouldIgnoreStatusBar
+        }]
+      };
+    }
+
+    if (arguments.length === 3) {
+      return longPress3.apply(null, arguments);
+    }
+
+    if (arguments.length === 4) {
+      return longPress4.apply(null, arguments);
+    }
+  }
+
 }
 
 module.exports = EspressoDetox;

package/src/copilot/DetoxCopilot.js

@@ -2,27 +2,15 @@ const copilot = require('detox-copilot').default;
 
 const detoxCopilotFrameworkDriver = require('./detoxCopilotFrameworkDriver');
 
+/**
+ * @typedef {Object} Detox.DetoxCopilotFacade
+ */
 class DetoxCopilot {
-  constructor() {
-    this.isInitialized = false;
-  }
-
   init(promptHandler) {
     copilot.init({
       frameworkDriver: detoxCopilotFrameworkDriver,
       promptHandler: promptHandler
     });
-
-    this.isInitialized = true;
-  }
-
-  resetIfNeeded() {
-    if (!this.isInitialized) {
-      // Copilot is not initialized, nothing to reset
-      return;
-    }
-
-    copilot.reset();
   }
 
   perform(...steps) {

package/src/copilot/detoxCopilotFrameworkDriver.js

@@ -18,7 +18,7 @@ const detoxCopilotFrameworkDriver = {
           },
           {
             signature: 'by.text(text: string)',
-            description: 'Matches elements by their text.',
+            description: 'Matches elements by their text (value).',
             example: "element(by.text('Login'))",
             guidelines: ['Prefer test IDs over text matchers when possible.'],
           },
@@ -34,6 +34,12 @@ const detoxCopilotFrameworkDriver = {
             example: "element(by.id('listItem')).atIndex(2)",
             guidelines: ['Use when multiple elements match the same matcher.'],
           },
+          {
+            signature: 'by.label(label: string)',
+            description: 'Match elements with the specified label.',
+            example: "element(by.label('Tuesday, 1 October'));",
+            guidelines: ['Use when there are no other identifiers, such as for date pickers to select specific days.'],
+          },
         ],
       },
       {
@@ -106,7 +112,7 @@ const detoxCopilotFrameworkDriver = {
             ],
           },
           {
-            signature: 'waitFor(element: Matcher)..toBeVisible().whileElement(element: Matcher).scroll(offset: number, direction: string)',
+            signature: 'waitFor(element: Matcher).toBeVisible(percent?: number).whileElement(element: Matcher).scroll(offset: number, direction: string)',
             description: 'Continuously performs an action while waiting for an expectation to be fulfilled.',
             example: `
 await waitFor(element(by.text('Load More')))
@@ -185,9 +191,13 @@ jestExpect(attributes.text).toBe('Tap Me');`,
         title: 'Assertions',
         items: [
           {
-            signature: 'toBeVisible()',
-            description: 'Asserts that the element is visible.',
-            example: "await expect(element(by.id('loginButton'))).toBeVisible();",
+            signature: 'toBeVisible(percent?: number)',
+            description: 'Asserts that the element is visible with at-least the specified percentage. Default percent is 75%.',
+            example: "await expect(element(by.id('loginButton'))).toBeVisible(38);",
+            guidelines: [
+              'Use the default visibility percent unless a different percentage is required.',
+              'If a percentage value is provided, use the exact percentage required for the test.',
+            ],
           },
           {
             signature: 'toExist()',
@@ -377,8 +387,8 @@ await device.launchApp({ launchArgs: { someLaunchArg: 1234 } });`,
         items: [
           {
             signature: 'web.element(matcher: Matcher)',
-            description: 'Selects an element within a web view. Use when there is only one web view on the screen.',
-            example: `    
+            description: 'Selects an element within a web view (`WKWebView` or `RNCWebView`). Use when there is only one web view on the screen.',
+            example: `
 await web.element(by.web.id('email')).typeText('test@example.com');
 await web.element(by.web.id('password')).typeText('password123');
 await web.element(by.web.id('login-button')).tap();
@@ -387,19 +397,20 @@ await web.element(by.web.id('login-button')).tap();
               'The web view may take time to load; add a delay using `await new Promise(resolve => setTimeout(resolve, milliseconds));` before the first interaction. This wait should happen only once.',
               'After the initial wait, you can interact with web elements without additional delays.',
               'Use `by.web.id` matcher when possible for matching web elements, as it is the most reliable.',
-              'Web APIs can only be used with web elements (within web views). Avoid using web APIs for native elements or native APIs for web elements.',
+              'Web APIs can only be used with web elements (within web views). Do not use web APIs for native elements or native APIs for web elements!',
+              'Confirm that you are targeting a web view before using this method.'
             ],
           },
           {
             signature: 'web(nativeMatcher: NativeMatcher).element(matcher: Matcher)',
-            description: 'Selects an element within a specific web view matched by a native matcher. Use when there are multiple web views on the screen.',
+            description: 'Selects an element within a specific web view (`WKWebView` or `RNCWebView`) matched by a native matcher. Use when there are multiple web views on the screen.',
             example: `
 // Wait for the specific web view to appear and load (only once before interacting)
 await expect(element(by.id('checkout-webview'))).toBeVisible();
 
 // Interact with elements within a specific web view
 const specificWebView = web(by.id('checkout-webview'));
-    
+
 await specificWebView.element(by.web.id('credit-card-number')).typeText('4111111111111111');
 await specificWebView.element(by.web.id('expiration-date')).typeText('12/25');
 await specificWebView.element(by.web.id('cvv')).typeText('123');
@@ -411,6 +422,7 @@ await specificWebView.element(by.web.id('pay-button')).tap();
               'After the initial wait, you can interact with elements within the web view without additional delays.',
               'Webview must be matched with `web(nativeMatcher)` (e.g., `web(by.id(..))` instead of `element(by.id(..))`).',
               'Prefer the basic `web.element()` if only one web view is present on the screen.',
+              'Confirm that you are targeting a web view before using this method.'
             ],
           },
           {
@@ -485,8 +497,8 @@ await secondWebView.element(by.web.id('search-button')).tap();
             example: `await web.element(by.web.label('Next')).tap();`,
             guidelines: [
               'Available on iOS only.',
-              'Use when the element has a unique label or aria-label.',
-              'Can be used to match buttons and input elements by their inner text content.',
+              'Use when the inner web element has a unique label or aria-label.',
+              'Can be used to match buttons and input elements inside a web view, by their inner text content.',
             ],
           },
           {
@@ -567,13 +579,13 @@ await web.element(by.web.id('email-input')).focus();
 await web.element(by.web.id('email-input')).typeText('user@example.com');
             `,
             guidelines: [
-              'Useful for input fields that require focus before typing.',
+              'Useful for input fields in a web view that require focus before typing.',
               'No need for secured interactions on iOS.',
             ]
           },
           {
             signature: 'moveCursorToEnd()',
-            description: 'Moves the input cursor to the end of the element\'s content.',
+            description: 'Moves the input cursor in a web view to the end of the element\'s content.',
             example: `
 await web.element(by.web.id('message-box')).moveCursorToEnd();
 await web.element(by.web.id('message-box')).typeText(' Adding more text.');
@@ -581,7 +593,7 @@ await web.element(by.web.id('message-box')).typeText(' Adding more text.');
           },
           {
             signature: 'runScript(script: string, args?: any[])',
-            description: 'Runs a JavaScript function on the element.',
+            description: 'Runs a JavaScript function on the web view element.',
             example: `
 // Click an element using a custom script
 await web.element(by.web.id('hidden-button')).runScript('el => el.click()');

package/src/devices/runtime/RuntimeDevice.js

@@ -1,6 +1,7 @@
 const DetoxRuntimeError = require('../../errors/DetoxRuntimeError');
 const debug = require('../../utils/debug'); // debug utils, leave here even if unused
 const log = require('../../utils/logger').child({ cat: 'device' });
+const mapDeviceLongPressArguments = require('../../utils/mapDeviceLongPressArguments');
 const traceMethods = require('../../utils/traceMethods');
 const wrapWithStackTraceCutter = require('../../utils/wrapWithStackTraceCutter');
 
@@ -283,6 +284,16 @@ class RuntimeDevice {
     await this.deviceDriver.setOrientation(orientation);
   }
 
+  async tap(point, shouldIgnoreStatusBar) {
+    await this.deviceDriver.tap(point, shouldIgnoreStatusBar, this._bundleId);
+  }
+
+  async longPress(arg1, arg2, arg3) {
+    let { point, duration, shouldIgnoreStatusBar } = mapDeviceLongPressArguments(arg1, arg2, arg3);
+
+    await this.deviceDriver.longPress(point, duration, shouldIgnoreStatusBar, this._bundleId);
+  }
+
   async setLocation(lat, lon) {
     lat = String(lat);
     lon = String(lon);

package/src/devices/runtime/drivers/DeviceDriverBase.js

@@ -51,6 +51,14 @@ class DeviceDriverBase {
     return '';
   }
 
+  async tap(_bundleId) {
+    return '';
+  }
+
+  async longPress(_bundleId) {
+    return '';
+  }
+
   async sendToHome() {
     return '';
   }

package/src/devices/runtime/drivers/android/AndroidDriver.js

@@ -245,6 +245,22 @@ class AndroidDriver extends DeviceDriverBase {
     await this.invocationManager.execute(call);
   }
 
+  async tap(point, shouldIgnoreStatusBar) {
+    let x = point?.x ?? 100;
+    let y = point?.y ?? 100;
+    let _shouldIgnoreStatusBar = shouldIgnoreStatusBar ?? true;
+    const call = EspressoDetoxApi.tap(x, y, _shouldIgnoreStatusBar);
+    await this.invocationManager.execute(call);
+  }
+
+  async longPress(point, duration, shouldIgnoreStatusBar) {
+    let x = point?.x ?? 100;
+    let y = point?.y ?? 100;
+    let _shouldIgnoreStatusBar = shouldIgnoreStatusBar ?? true;
+    const call = duration ? EspressoDetoxApi.longPress(x, y, duration, _shouldIgnoreStatusBar): EspressoDetoxApi.longPress(x, y, _shouldIgnoreStatusBar);
+    await this.invocationManager.execute(call);
+  }
+  
   async generateViewHierarchyXml(shouldInjectTestIds) {
     const hierarchy = await this.invocationManager.execute(DetoxApi.generateViewHierarchyXml(shouldInjectTestIds));
     return hierarchy.result;