detox 20.0.6-breaking.new-global-lifecycle.0 → 20.0.7-prerelease.0

package/Detox-android/com/wix/detox/20.0.7-prerelease.0/detox-20.0.7-prerelease.0-javadoc.jar.md5

@@ -0,0 +1 @@
+effab7a47e7869043e38424a2a1320ee

package/Detox-android/com/wix/detox/20.0.7-prerelease.0/detox-20.0.7-prerelease.0-javadoc.jar.sha1

@@ -0,0 +1 @@
+6ee9bcfa6e27561a20785f38d6978a16091d3da2

package/Detox-android/com/wix/detox/20.0.7-prerelease.0/detox-20.0.7-prerelease.0-javadoc.jar.sha256

@@ -0,0 +1 @@
+06ad5ed2c2c02a65f50c2913c88d9d83361b43decd36f3094ebbe088bbb5f784

package/Detox-android/com/wix/detox/20.0.7-prerelease.0/detox-20.0.7-prerelease.0-javadoc.jar.sha512

@@ -0,0 +1 @@
+4eaa276ed4517115f488a2fd76b24df233eb630eacf10544a90d7ef57ab0bf827d7495c9b0f39fd79edf7568bbde0b693d8bec308257bc1f0804a7dc6a32161f

package/Detox-android/com/wix/detox/20.0.7-prerelease.0/detox-20.0.7-prerelease.0-sources.jar.md5

@@ -0,0 +1 @@
+61e4258cf4c8c851cfafb2103a2d3b5e

package/Detox-android/com/wix/detox/20.0.7-prerelease.0/detox-20.0.7-prerelease.0-sources.jar.sha1

@@ -0,0 +1 @@
+f4fe7c3a998cef8964ff7f5af05eb529b38e09ee

package/Detox-android/com/wix/detox/20.0.7-prerelease.0/detox-20.0.7-prerelease.0-sources.jar.sha256

@@ -0,0 +1 @@
+114b949bbbf5f8fe5f6f355f5f629edb38e08e2221b6303e34a638c7bb824765

package/Detox-android/com/wix/detox/20.0.7-prerelease.0/detox-20.0.7-prerelease.0-sources.jar.sha512

@@ -0,0 +1 @@
+c77832e978a4e102716c7fd6fa70d04645e02c8a377bdf09cfa482a8f70a514c5d35d7dd4f0c10b5dcd690817a3fb740f2a7914fc905a22489522e7363f9f44d

package/Detox-android/com/wix/detox/20.0.7-prerelease.0/detox-20.0.7-prerelease.0.aar.md5

@@ -0,0 +1 @@
+90f9a8b95a3f10adc93442d4f4684092

package/Detox-android/com/wix/detox/20.0.7-prerelease.0/detox-20.0.7-prerelease.0.aar.sha1

@@ -0,0 +1 @@
+f03ce7143af53f09f8734c8ee3eb5a532f8143fa

package/Detox-android/com/wix/detox/20.0.7-prerelease.0/detox-20.0.7-prerelease.0.aar.sha256

@@ -0,0 +1 @@
+742ad662c67c18780e0844567205b1d02772f160b1876154cbe485bf8048c461

package/Detox-android/com/wix/detox/20.0.7-prerelease.0/detox-20.0.7-prerelease.0.aar.sha512

@@ -0,0 +1 @@
+dfd697ec8d6f5ee8296379bbbf3f5b487ad70a729a658c6118b2e4923c10959bdd56a30959eb48afa1cf0bfe210ba8a500423d6b9f3993c2570505d59288c0de

package/Detox-android/com/wix/detox/{20.0.6-breaking.new-global-lifecycle.0/detox-20.0.6-breaking.new-global-lifecycle.0.pom → 20.0.7-prerelease.0/detox-20.0.7-prerelease.0.pom}

@@ -3,7 +3,7 @@
   <modelVersion>4.0.0</modelVersion>
   <groupId>com.wix</groupId>
   <artifactId>detox</artifactId>
-  <version>20.0.6-breaking.new-global-lifecycle.0</version>
+  <version>20.0.7-prerelease.0</version>
   <packaging>aar</packaging>
   <name>Detox</name>
   <description>Gray box end-to-end testing and automation library for mobile apps</description>

package/Detox-android/com/wix/detox/20.0.7-prerelease.0/detox-20.0.7-prerelease.0.pom.md5

@@ -0,0 +1 @@
+7bf66c5ea2c958c30ac7565193ba4bc8

package/Detox-android/com/wix/detox/20.0.7-prerelease.0/detox-20.0.7-prerelease.0.pom.sha1

@@ -0,0 +1 @@
+2485b54c1a62e1557d76ebc51a1741ccc4f10304

package/Detox-android/com/wix/detox/20.0.7-prerelease.0/detox-20.0.7-prerelease.0.pom.sha256

@@ -0,0 +1 @@
+d133d5b090110c223f578f117b344a1bb1e86c3df2d55f50dfd00f1b17498254

package/Detox-android/com/wix/detox/20.0.7-prerelease.0/detox-20.0.7-prerelease.0.pom.sha512

@@ -0,0 +1 @@
+11a29cc20eb22ce2133475e187c0941b7d32bff186857ddceb2ee88f3f3b1d46e32eb0cbed032598f57933cca7b9ed8d36008d9c8b882dc202afdd20d9fe5def

package/Detox-android/com/wix/detox/maven-metadata.xml

@@ -3,11 +3,11 @@
   <groupId>com.wix</groupId>
   <artifactId>detox</artifactId>
   <versioning>
-    <latest>20.0.6-breaking.new-global-lifecycle.0</latest>
-    <release>20.0.6-breaking.new-global-lifecycle.0</release>
+    <latest>20.0.7-prerelease.0</latest>
+    <release>20.0.7-prerelease.0</release>
     <versions>
-      <version>20.0.6-breaking.new-global-lifecycle.0</version>
+      <version>20.0.7-prerelease.0</version>
     </versions>
-    <lastUpdated>20220905115247</lastUpdated>
+    <lastUpdated>20220906143110</lastUpdated>
   </versioning>
 </metadata>

package/Detox-android/com/wix/detox/maven-metadata.xml.md5

@@ -1 +1 @@
-97dde91895b9c45b58fb7cc6364a9e8d
+443209a3d276fc780cececc129d8e70b

package/Detox-android/com/wix/detox/maven-metadata.xml.sha1

@@ -1 +1 @@
-11290dd2dfe8f2c159e0e12f674e42613903c592
+283f03aa8235477f8b3070d4cfa36018d5a7fe7f

package/Detox-android/com/wix/detox/maven-metadata.xml.sha256

@@ -1 +1 @@
-077984469b0de32349680ac5d31fd15ad7f4bc9bbcb81cc9e6a1138a14c5ad57
+40762b77b08b8369c14f0f11ecf0832d7fd56ecaa618b1a0a62c3c5d16938ed9

package/Detox-android/com/wix/detox/maven-metadata.xml.sha512

@@ -1 +1 @@
-15ce6f12a05807a757acb5ae887aac0ffac8cc2738327275ada27b3b4849662a832fce5203d3a5aca7223b49b438176e990204726878456f5cb9dadb0f1a38d9
+5b3fceef49c72fa0bd12736858bf0e6f16cefc317c648ff83525d2fdc4b7831cce101c206d3640ba7a79edc432b90d481f279cba5285f7c36ce1f613caf163f6

package/android/detox/proguard-rules-app.pro

@@ -6,6 +6,10 @@
 -keep class com.facebook.react.ReactNativeHost { *; }
 -keep class com.facebook.react.ReactInstanceManager { *; }
 -keep class com.facebook.react.ReactInstanceManager** { *; }
+-keep class com.facebook.react.ReactInstanceEventListener { *; }
+
+-keep class com.facebook.react.views.slider.ReactSlider { *; }
+-keep class com.reactnativecommunity.slider.ReactSlider { *; }
 -keep class com.reactnativecommunity.asyncstorage.** { *; }
 
 -keep class kotlin.jvm.** { *; }

package/android/detox/src/full/java/com/wix/detox/DetoxCrashHandler.kt

@@ -6,7 +6,7 @@ import com.wix.detox.adapters.server.OutboundServerAdapter
 class DetoxCrashHandler(private val outboundServerAdapter: OutboundServerAdapter) {
     fun attach() {
         Thread.setDefaultUncaughtExceptionHandler { thread, exception ->
-            Log.e(LOG_TAG, "Crash detected!!! thread=${thread.name} (${thread.id})")
+            Log.e(LOG_TAG, "Crash detected!!! thread=${thread.name} (${thread.id})", exception)
 
             val crashInfo = mapOf("errorDetails" to "@Thread ${thread.name}(${thread.id}):\n${Log.getStackTraceString(exception)}\nCheck device logs for full details!")
             outboundServerAdapter.sendMessage(ACTION_NAME, crashInfo, MESSAGE_ID)

package/android/detox/src/full/java/com/wix/detox/LaunchArgs.java

@@ -14,6 +14,7 @@ public class LaunchArgs {
     private static final String DETOX_NOTIFICATION_PATH_ARG = "detoxUserNotificationDataURL";
     private static final String DETOX_BLACKLIST_URLS_ARG = "detoxURLBlacklistRegex";
     private static final String DETOX_URL_OVERRIDE_ARG = "detoxURLOverride";
+    private static final String DETOX_ENABLE_SYNCHRONIZATION = "detoxEnableSynchronization";
     private static final List<String> RESERVED_INSTRUMENTATION_ARGS = Arrays.asList("class", "package", "func", "unit", "size", "perf", "debug", "log", "emma", "coverageFile");
 
     public boolean hasNotificationPath() {
@@ -36,6 +37,14 @@ public class LaunchArgs {
         return InstrumentationRegistry.getArguments().containsKey(DETOX_BLACKLIST_URLS_ARG);
     }
 
+    public String getEnableSynchronization() {
+        return InstrumentationRegistry.getArguments().getString(DETOX_ENABLE_SYNCHRONIZATION);
+    }
+
+    public boolean hasEnableSynchronization() {
+        return InstrumentationRegistry.getArguments().containsKey(DETOX_ENABLE_SYNCHRONIZATION);
+    }
+
     public String getUrlOverride() {
         return InstrumentationRegistry.getArguments().getString(DETOX_URL_OVERRIDE_ARG);
     }

package/android/detox/src/full/java/com/wix/detox/TestEngineFacade.kt

@@ -10,7 +10,7 @@ import com.wix.detox.reactnative.ReactNativeExtension
 
 class TestEngineFacade {
     fun awaitIdle(): Unit? = Espresso.onIdle() {
-        Log.i(LOG_TAG, "Wait is over: app is now idle!")
+        Log.i(LOG_TAG, "Wait is over: App is now idle!")
         null
     }
     fun syncIdle() = UiAutomatorHelper.espressoSync() // TODO Check whether this can be replaced with #awaitIdle()

package/android/detox/src/full/java/com/wix/detox/reactnative/ReactNativeExtension.kt

@@ -39,7 +39,7 @@ object ReactNativeExtension {
             reloadReactNativeInBackground(it)
             val reactContext = awaitNewReactNativeContext(it, previousReactContext)
 
-            setupIdlingResources(reactContext, networkSyncEnabled)
+            enableOrDisableSynchronization(reactContext, networkSyncEnabled)
             hackRN50OrHigherWaitForReady()
         }
     }
@@ -58,7 +58,7 @@ object ReactNativeExtension {
         (applicationContext as ReactApplication).let {
             val reactContext = awaitNewReactNativeContext(it, null)
 
-            setupIdlingResources(reactContext)
+            enableOrDisableSynchronization(reactContext)
             hackRN50OrHigherWaitForReady()
         }
     }
@@ -124,6 +124,19 @@ object ReactNativeExtension {
         return rnLoadingMonitor.getNewContext()!!
     }
 
+    private fun enableOrDisableSynchronization(reactContext: ReactContext, networkSyncEnabled: Boolean = true) {
+        if (shouldDisableSynchronization()) {
+            clearAllSynchronization()
+        } else {
+            setupIdlingResources(reactContext, networkSyncEnabled)
+        }
+    }
+
+    private fun shouldDisableSynchronization(): Boolean {
+        val launchArgs = LaunchArgs()
+        return launchArgs.hasEnableSynchronization() && launchArgs.enableSynchronization.equals("0")
+    }
+
     private fun setupIdlingResources(reactContext: ReactContext, networkSyncEnabled: Boolean = true) {
         val launchArgs = LaunchArgs()
 

package/android/detox/src/full/java/com/wix/detox/reactnative/ReactNativeIdlingResources.kt

@@ -2,6 +2,7 @@ package com.wix.detox.reactnative
 
 import android.os.Looper
 import android.util.Log
+import androidx.test.espresso.Espresso
 import androidx.test.espresso.IdlingRegistry
 import androidx.test.espresso.base.IdlingResourceRegistry
 import com.facebook.react.bridge.ReactContext
@@ -12,7 +13,6 @@ import com.wix.detox.reactnative.idlingresources.timers.getInterrogationStrategy
 import com.wix.detox.reactnative.idlingresources.uimodule.UIModuleIdlingResource
 import org.joor.Reflect
 import org.joor.ReflectException
-import java.util.Set
 
 private const val LOG_TAG = "DetoxRNIdleRes"
 
@@ -46,15 +46,11 @@ private class MQThreadReflected(private val queue: Any?, private val queueName:
 }
 
 class ReactNativeIdlingResources constructor(
-        private val reactContext: ReactContext,
-        private var launchArgs: LaunchArgs,
-        internal var networkSyncEnabled: Boolean = true
-        )
-
-    {
-
+    private val reactContext: ReactContext,
+    private var launchArgs: LaunchArgs,
+    internal var networkSyncEnabled: Boolean = true
+) {
     companion object {
-        private const val FIELD_UI_BG_MSG_QUEUE = "mUiBackgroundMessageQueueThread"
         private const val FIELD_NATIVE_MODULES_MSG_QUEUE = "mNativeModulesMessageQueueThread"
         private const val FIELD_JS_MSG_QUEUE = "mJSMessageQueueThread"
     }
@@ -69,17 +65,11 @@ class ReactNativeIdlingResources constructor(
 
     fun registerAll() {
         Log.i(LOG_TAG, "Setting up Espresso Idling Resources for React Native")
-
         unregisterAll()
 
-        if (launchArgs.hasURLBlacklist()) {
-            val blacklistUrls = launchArgs.getURLBlacklist()
-            setBlacklistUrls(blacklistUrls)
-        }
-
+        setupUrlBlacklist()
         setupMQThreadsInterrogators()
         syncIdlingResources()
-
         setupCustomRNIdlingResources()
         syncIdlingResources()
     }
@@ -108,28 +98,42 @@ class ReactNativeIdlingResources constructor(
             networkIdlingResource?.resume()
         }
     }
+
     fun pauseRNTimersIdlingResource() = timersIdlingResource?.pause()
     fun resumeRNTimersIdlingResource() = timersIdlingResource?.resume()
     fun pauseUIIdlingResource() = uiModuleIdlingResource?.pause()
     fun resumeUIIdlingResource() = uiModuleIdlingResource?.resume()
-    fun pauseJSBridgeIdlingResource() = rnBridgeIdlingResource?.pause()
-    fun resumeJSBridgeIdlingResource() = rnBridgeIdlingResource?.resume()
+
+    fun setBlacklistUrls(urlList: String) {
+        setIldingResourceBlacklist(urlList)
+    }
+
+    private fun setIldingResourceBlacklist(urlList: String) {
+        val urlArray = toFormattedUrlArray(urlList)
+        NetworkIdlingResource.setURLBlacklist(urlArray)
+    }
 
     private fun setupMQThreadsInterrogators() {
         if (IdlingRegistry.getInstance().loopers.isEmpty()) {
             val mqThreadsReflector = MQThreadsReflector(reactContext)
-//            val mqUIBackground = mqThreadsReflector.getQueue(FIELD_UI_BG_MSG_QUEUE)?.getLooper() TODO
             val mqJS = mqThreadsReflector.getQueue(FIELD_JS_MSG_QUEUE)?.getLooper()
-            val mqNativeModules = mqThreadsReflector.getQueue(FIELD_NATIVE_MODULES_MSG_QUEUE)?.getLooper()
+            val mqNativeModules =
+                mqThreadsReflector.getQueue(FIELD_NATIVE_MODULES_MSG_QUEUE)?.getLooper()
 
             IdlingRegistry.getInstance().apply {
-//                registerLooperAsIdlingResource(mqUIBackground)
                 registerLooperAsIdlingResource(mqJS)
                 registerLooperAsIdlingResource(mqNativeModules)
             }
         }
     }
 
+    private fun setupUrlBlacklist() {
+        if (launchArgs.hasURLBlacklist()) {
+            val blacklistUrls = launchArgs.urlBlacklist
+            setIldingResourceBlacklist(blacklistUrls)
+        }
+    }
+
     private fun setupCustomRNIdlingResources() {
         rnBridgeIdlingResource = BridgeIdlingResource(reactContext)
         timersIdlingResource = TimersIdlingResource(getInterrogationStrategy(reactContext)!!)
@@ -151,13 +155,16 @@ class ReactNativeIdlingResources constructor(
 
     private fun syncIdlingResources() {
         IdlingRegistry.getInstance().apply {
-            val irr: IdlingResourceRegistry = Reflect.on(androidx.test.espresso.Espresso::class.java).field("baseRegistry").get()
+            val irr: IdlingResourceRegistry =
+                Reflect.on(Espresso::class.java).field("baseRegistry").get()
             irr.sync(this.resources, this.loopers)
         }
     }
 
     private fun unregisterMQThreadsInterrogators() {
-        Reflect.on(IdlingRegistry.getInstance()).field("loopers").get<Set<Any>>().clear()
+        val idlingResourceInstance = IdlingRegistry.getInstance()
+        val loopersField = Reflect.on(idlingResourceInstance).field("loopers")
+        loopersField.get<MutableSet<Any>>().clear()
     }
 
     private fun unregisterCustomRNIdlingResources() {
@@ -166,7 +173,8 @@ class ReactNativeIdlingResources constructor(
                 timersIdlingResource,
                 rnBridgeIdlingResource,
                 uiModuleIdlingResource,
-                animIdlingResource)
+                animIdlingResource
+            )
         rnBridgeIdlingResource?.onDetach()
 
         removeNetworkIdlingResource()
@@ -174,13 +182,15 @@ class ReactNativeIdlingResources constructor(
     }
 
     private fun setupAsyncStorageIdlingResource() {
-        asyncStorageIdlingResource = AsyncStorageIdlingResource.createIfNeeded(reactContext, false)?.also {
-            IdlingRegistry.getInstance().register(it)
-        }
+        asyncStorageIdlingResource =
+            AsyncStorageIdlingResource.createIfNeeded(reactContext, false)?.also {
+                IdlingRegistry.getInstance().register(it)
+            }
 
-        legacyAsyncStorageIdlingResource = AsyncStorageIdlingResource.createIfNeeded(reactContext, true)?.also {
-            IdlingRegistry.getInstance().register(it)
-        }
+        legacyAsyncStorageIdlingResource =
+            AsyncStorageIdlingResource.createIfNeeded(reactContext, true)?.also {
+                IdlingRegistry.getInstance().register(it)
+            }
     }
 
     private fun removeAsyncStorageIdlingResource() {
@@ -212,13 +222,8 @@ class ReactNativeIdlingResources constructor(
 
     private fun toFormattedUrlArray(urlList: String): List<String> {
         var formattedUrls = urlList
-        formattedUrls = formattedUrls.replace(Regex("""[()"]"""), "");
-        formattedUrls = formattedUrls.trim();
-        return formattedUrls.split(',');
-    }
-
-    fun setBlacklistUrls(urlList: String) {
-        val urlArray = toFormattedUrlArray(urlList)
-        NetworkIdlingResource.setURLBlacklist(urlArray);
+        formattedUrls = formattedUrls.replace(Regex("""[()"]"""), "")
+        formattedUrls = formattedUrls.trim()
+        return formattedUrls.split(',')
     }
 }

package/index.d.ts

@@ -353,12 +353,21 @@ declare global {
                 readonly startSection: (name: string) => void;
                 /** @deprecated */
                 readonly endSection: (name: string) => void;
+                /** @private */
+                readonly invocationCall: (...args: unknown[]) => unknown;
             };
 
             /**
+             * Trace a single call, with a given name and arguments.
+             *
              * @deprecated
+             * @param sectionName The name of the section to trace.
+             * @param promiseOrFunction Promise or a function that provides a promise.
+             * @param args Optional arguments to pass to the trace.
+             * @returns The returned value of the traced call.
+             * @see https://wix.github.io/Detox/docs/next/api/detox-object-api/#detoxtracecall.
              */
-            readonly traceCall: <T>(event: string, action: () => Promise<T>) => Promise<T>;
+            readonly traceCall: <T>(event: string, action: () => Promise<T>, args?: Record<string, unknown>) => Promise<T>;
         }
 
         interface Logger {

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "detox",
   "description": "E2E tests and automation for mobile",
-  "version": "20.0.6-breaking.new-global-lifecycle.0",
+  "version": "20.0.7-prerelease.0",
   "bin": {
     "detox": "local-cli/cli.js"
   },
@@ -184,5 +184,5 @@
       }
     }
   },
-  "gitHead": "29baf7cab1ff919fd57d11f5e41664e741777f76"
+  "gitHead": "4b75f39310b93707f01e2bb38a4fba4d385e8acd"
 }

package/runners/jest/testEnvironment/index.js

@@ -1,5 +1,6 @@
-// @ts-nocheck
-const maybeNodeEnvironment = require('jest-environment-node'); // eslint-disable-line node/no-extraneous-require
+const resolveFrom = require('resolve-from');
+const maybeNodeEnvironment = require(resolveFrom(process.cwd(), 'jest-environment-node'));
+// @ts-ignore
 const NodeEnvironment = maybeNodeEnvironment.default || maybeNodeEnvironment;
 
 const detox = require('../../../internals');

package/src/DetoxWorker.js

@@ -195,7 +195,6 @@ class DetoxWorker {
   onTestStart = async (testSummary) => {
     if (this._isCleaningUp) return;
     this._validateTestSummary('beforeEach', testSummary);
-    this._logTestRunCheckpoint('DETOX_BEFORE_EACH', testSummary);
 
     if (this._isCleaningUp) return;
     await this._dumpUnhandledErrorsIfAny({
@@ -215,7 +214,6 @@ class DetoxWorker {
   onTestDone = async (testSummary) => {
     if (this._isCleaningUp) return;
     this._validateTestSummary('afterEach', testSummary);
-    this._logTestRunCheckpoint('DETOX_AFTER_EACH', testSummary);
 
     if (this._isCleaningUp) return;
     await this._artifactsManager.onTestDone(testSummary);
@@ -251,10 +249,6 @@ class DetoxWorker {
     }
   }
 
-  _logTestRunCheckpoint(event, { status, fullName }) {
-    this.log.trace({ event, status }, `${status} test: ${JSON.stringify(fullName)}`);
-  }
-
   _validateTestSummary(methodName, testSummary) {
     if (!_.isPlainObject(testSummary)) {
       throw this._runtimeErrorComposer.invalidTestSummary(methodName, testSummary);

package/src/android/core/NativeElement.js

@@ -5,6 +5,7 @@ const tempfile = require('tempfile');
 
 const DetoxRuntimeError = require('../../errors/DetoxRuntimeError');
 const invoke = require('../../invoke');
+const { actionDescription } = require('../../utils/invocationTraceDescriptions');
 const actions = require('../actions/native');
 const DetoxMatcherApi = require('../espressoapi/DetoxMatcher');
 const { ActionInteraction } = require('../interactions/native');
@@ -18,12 +19,11 @@ class NativeElement {
   }
 
   _selectElementWithMatcher(matcher) {
-    // if (!(matcher instanceof NativeMatcher)) throw new DetoxRuntimeError(`Element _selectElementWithMatcher argument must be a valid NativeMatcher, got ${typeof matcher}`);
     this._call = invoke.call(invoke.Espresso, 'onView', matcher._call);
   }
 
   atIndex(index) {
-    if (typeof index !== 'number') throw new DetoxRuntimeError(`Element atIndex argument must be a number, got ${typeof index}`);
+    if (typeof index !== 'number') throw new DetoxRuntimeError({ message: `Element atIndex argument must be a number, got ${typeof index}` });
     const matcher = this._originalMatcher;
     this._originalMatcher._call = invoke.callDirectly(DetoxMatcherApi.matcherForAtIndex(index, matcher._call.value));
 
@@ -32,56 +32,84 @@ class NativeElement {
   }
 
   async tap(value) {
-    return await new ActionInteraction(this._invocationManager, this, new actions.TapAction(value)).execute();
+    const action = new actions.TapAction(value);
+    const traceDescription = actionDescription.tapAtPoint(value);
+    return await new ActionInteraction(this._invocationManager, this, action, traceDescription).execute();
   }
 
   async tapAtPoint(value) {
-    return await new ActionInteraction(this._invocationManager, this, new actions.TapAtPointAction(value)).execute();
+    const action = new actions.TapAtPointAction(value);
+    const traceDescription = actionDescription.tapAtPoint(value);
+    return await new ActionInteraction(this._invocationManager, this, action, traceDescription).execute();
   }
 
   async longPress() {
-    return await new ActionInteraction(this._invocationManager, this, new actions.LongPressAction()).execute();
+    const action = new actions.LongPressAction();
+    const traceDescription = actionDescription.longPress();
+    return await new ActionInteraction(this._invocationManager, this, action, traceDescription).execute();
   }
 
   async multiTap(times) {
-    return await new ActionInteraction(this._invocationManager, this, new actions.MultiClickAction(times)).execute();
+    if (typeof times !== 'number') throw new Error('times should be a number, but got ' + (times + (' (' + (typeof times + ')'))));
+    if (times < 1) throw new Error('times should be greater than 0, but got ' + times);
+
+    const action = new actions.MultiClickAction(times);
+    const traceDescription = actionDescription.multiTap(times);
+    return await new ActionInteraction(this._invocationManager, this, action, traceDescription).execute();
   }
 
   async tapBackspaceKey() {
-    return await new ActionInteraction(this._invocationManager, this, new actions.PressKeyAction(67)).execute();
+    const action = new actions.PressKeyAction(67);
+    const traceDescription = actionDescription.tapBackspaceKey();
+    return await new ActionInteraction(this._invocationManager, this, action, traceDescription).execute();
   }
 
   async tapReturnKey() {
-    return await new ActionInteraction(this._invocationManager, this, new actions.TypeTextAction('\n')).execute();
+    const action = new actions.TypeTextAction('\n');
+    const traceDescription = actionDescription.tapReturnKey();
+    return await new ActionInteraction(this._invocationManager, this, action, traceDescription).execute();
   }
 
   async typeText(value) {
-    return await new ActionInteraction(this._invocationManager, this, new actions.TypeTextAction(value)).execute();
+    const action = new actions.TypeTextAction(value);
+    const traceDescription = actionDescription.typeText(value);
+    return await new ActionInteraction(this._invocationManager, this, action, traceDescription).execute();
   }
 
   async replaceText(value) {
-    return await new ActionInteraction(this._invocationManager, this, new actions.ReplaceTextAction(value)).execute();
+    const action = new actions.ReplaceTextAction(value);
+    const traceDescription = actionDescription.replaceText(value);
+    return await new ActionInteraction(this._invocationManager, this, action, traceDescription).execute();
   }
 
   async clearText() {
-    return await new ActionInteraction(this._invocationManager, this, new actions.ClearTextAction()).execute();
+    const action = new actions.ClearTextAction();
+    const traceDescription = actionDescription.clearText();
+    return await new ActionInteraction(this._invocationManager, this, action, traceDescription).execute();
   }
 
   async scroll(amount, direction = 'down', startPositionX, startPositionY) {
-    // override the user's element selection with an extended matcher that looks for UIScrollView children
-    // this._selectElementWithMatcher(this._originalMatcher._extendToDescendantScrollViews());
-    return await new ActionInteraction(this._invocationManager, this, new actions.ScrollAmountAction(direction, amount, startPositionX, startPositionY)).execute();
+    const action = new actions.ScrollAmountAction(direction, amount, startPositionX, startPositionY);
+    const traceDescription = actionDescription.scroll(amount, direction, startPositionX, startPositionY);
+    return await new ActionInteraction(this._invocationManager, this, action, traceDescription).execute();
   }
 
   async scrollTo(edge) {
     // override the user's element selection with an extended matcher that looks for UIScrollView children
     this._selectElementWithMatcher(this._originalMatcher._extendToDescendantScrollViews());
-    return await new ActionInteraction(this._invocationManager, this, new actions.ScrollEdgeAction(edge)).execute();
+
+    const action = new actions.ScrollEdgeAction(edge);
+    const traceDescription = actionDescription.scrollTo(edge);
+    return await new ActionInteraction(this._invocationManager, this, action, traceDescription).execute();
   }
 
   async scrollToIndex(index) {
+    // override the user's element selection with an extended matcher that looks for UIScrollView children
     this._selectElementWithMatcher(this._originalMatcher._extendToDescendantScrollViews());
-    return await new ActionInteraction(this._invocationManager, this, new actions.ScrollToIndex(index)).execute();
+
+    const action = new actions.ScrollToIndex(index);
+    const traceDescription = actionDescription.scrollToIndex(index);
+    return await new ActionInteraction(this._invocationManager, this, action, traceDescription).execute();
   }
 
   /**
@@ -96,13 +124,17 @@ class NativeElement {
 
     // override the user's element selection with an extended matcher that avoids RN issues with RCTScrollView
     this._selectElementWithMatcher(this._originalMatcher._avoidProblematicReactNativeElements());
+
     const action = new actions.SwipeAction(direction, speed, normalizedSwipeOffset, normalizedStartingPointX, normalizedStartingPointY);
-    return await new ActionInteraction(this._invocationManager, this, action).execute();
+    const traceDescription = actionDescription.swipe(direction, speed, normalizedSwipeOffset, normalizedStartingPointX, normalizedStartingPointY);
+    return await new ActionInteraction(this._invocationManager, this, action, traceDescription).execute();
   }
 
   async takeScreenshot(screenshotName) {
     // TODO this should be moved to a lower-layer handler of this use-case
-    const resultBase64 = await new ActionInteraction(this._invocationManager, this, new actions.TakeElementScreenshot()).execute();
+    const action = new actions.TakeElementScreenshot();
+    const traceDescription = actionDescription.takeScreenshot(screenshotName);
+    const resultBase64 = await new ActionInteraction(this._invocationManager, this, action, traceDescription).execute();
     const filePath = tempfile('detox.element-screenshot.png');
     await fs.writeFile(filePath, resultBase64, 'base64');
 
@@ -115,12 +147,16 @@ class NativeElement {
   }
 
   async getAttributes() {
-    const result = await new ActionInteraction(this._invocationManager, this, new actions.GetAttributes()).execute();
+    const action = new actions.GetAttributes();
+    const traceDescription = actionDescription.getAttributes();
+    const result = await new ActionInteraction(this._invocationManager, this, action, traceDescription).execute();
     return JSON.parse(result);
   }
 
   async adjustSliderToPosition(newPosition) {
-    return await new ActionInteraction(this._invocationManager, this, new actions.AdjustSliderToPosition(newPosition)).execute();
+    const action = new actions.AdjustSliderToPosition(newPosition);
+    const traceDescription = actionDescription.adjustSliderToPosition(newPosition);
+    return await new ActionInteraction(this._invocationManager, this, action, traceDescription).execute();
   }
 }