detox 19.10.0 → 19.11.0

package/Detox-android/com/wix/detox/19.11.0/detox-19.11.0-javadoc.jar.md5

@@ -0,0 +1 @@
+9aba5676c7298fb259def31abb2391c2

package/Detox-android/com/wix/detox/19.11.0/detox-19.11.0-javadoc.jar.sha1

@@ -0,0 +1 @@
+8489941696f685e4d9ee0f2695e524a9ee882ff7

package/Detox-android/com/wix/detox/19.11.0/detox-19.11.0-javadoc.jar.sha256

@@ -0,0 +1 @@
+5c074864be82defddfe6f03d23f1023718773a6caf867fd6de97306167b96c10

package/Detox-android/com/wix/detox/19.11.0/detox-19.11.0-javadoc.jar.sha512

@@ -0,0 +1 @@
+fc404aa3532e1bf13a1e12871b9a4d6c27575cacdfae5b76179308f321091b67d60f5a81e74bd0b3d6304a7930c3a9f79d15015fda37d4cdc5cb849274eb4b6b

package/Detox-android/com/wix/detox/19.11.0/detox-19.11.0-sources.jar.md5

@@ -0,0 +1 @@
+c607efb999d878b919150d3c868094fe

package/Detox-android/com/wix/detox/19.11.0/detox-19.11.0-sources.jar.sha1

@@ -0,0 +1 @@
+18641f7574235c6ec8c81ea52b75442ce919f213

package/Detox-android/com/wix/detox/19.11.0/detox-19.11.0-sources.jar.sha256

@@ -0,0 +1 @@
+0e23270810340a40547ede0002fb741353646db1878d5825f67a2212a13d3d41

package/Detox-android/com/wix/detox/19.11.0/detox-19.11.0-sources.jar.sha512

@@ -0,0 +1 @@
+440caa1e9ede22144e4f55d2c2c034c13e4b336f9f387f0fa0811bd651612c0bef7981c1b1ae826ab78519185c930a9287a6c6f3c76a554184282fdf8684a344

package/Detox-android/com/wix/detox/19.11.0/detox-19.11.0.aar.md5

@@ -0,0 +1 @@
+88fff568e621751c02f293579cce453a

package/Detox-android/com/wix/detox/19.11.0/detox-19.11.0.aar.sha1

@@ -0,0 +1 @@
+9398e3ea8573a634ddc61abf4f6b21d9e17ba728

package/Detox-android/com/wix/detox/19.11.0/detox-19.11.0.aar.sha256

@@ -0,0 +1 @@
+ae00e739f49017b43024ff3a508e03dafa7f002b406a746f43f742fa6c21cd15

package/Detox-android/com/wix/detox/19.11.0/detox-19.11.0.aar.sha512

@@ -0,0 +1 @@
+0239c96c8027c9274b6823bfadd5ddea7ca0803db694f53ee30d0d39b8ce5c4dd8d72f4e7d0af089db5d722fecf629e81b62759b5dc4cc434be86910b9b37f5d

package/Detox-android/com/wix/detox/{19.10.0/detox-19.10.0.pom → 19.11.0/detox-19.11.0.pom}

@@ -3,7 +3,7 @@
   <modelVersion>4.0.0</modelVersion>
   <groupId>com.wix</groupId>
   <artifactId>detox</artifactId>
-  <version>19.10.0</version>
+  <version>19.11.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/19.11.0/detox-19.11.0.pom.md5

@@ -0,0 +1 @@
+2300f079161364c78e01d8c27334ac7f

package/Detox-android/com/wix/detox/19.11.0/detox-19.11.0.pom.sha1

@@ -0,0 +1 @@
+1031ee5586ac864c9b0cbcaa5876dfbc07325f1f

package/Detox-android/com/wix/detox/19.11.0/detox-19.11.0.pom.sha256

@@ -0,0 +1 @@
+25d21ff3daef4e4da80808464fc808efbd4d0fa75f5e88ce9376fb1d85a922d8

package/Detox-android/com/wix/detox/19.11.0/detox-19.11.0.pom.sha512

@@ -0,0 +1 @@
+c1fae4e858403138b44db05d47128f74c1ac8b14a9f55dcae90ef90800040507bb8bdd97af6c64d26811ddcdf14be1a341531e4c8a4fab0323f500167b4d3499

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

@@ -3,11 +3,11 @@
   <groupId>com.wix</groupId>
   <artifactId>detox</artifactId>
   <versioning>
-    <latest>19.10.0</latest>
-    <release>19.10.0</release>
+    <latest>19.11.0</latest>
+    <release>19.11.0</release>
     <versions>
-      <version>19.10.0</version>
+      <version>19.11.0</version>
     </versions>
-    <lastUpdated>20220818130424</lastUpdated>
+    <lastUpdated>20220831134632</lastUpdated>
   </versioning>
 </metadata>

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

@@ -1 +1 @@
-38d31df24edd01e6923c2e3670359d6e
+63739c1fd16a9d1140a49b7857aa0fdf

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

@@ -1 +1 @@
-b4a03bfc096cae92a22fabe9ae811709c09c4b92
+0dcec1feec1b37fdf53e88ab4779a702631cd864

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

@@ -1 +1 @@
-504204669f5f3377f1c42725d55e8dcf742dc0c38318209978991dfe96abf831
+e1c67c307a105c7c7c82fae75e7d56f8b9718b1bb7dc9f604560909f39dce425

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

@@ -1 +1 @@
-a36b581589d46796551b3fccad8a460b3ef5e5ee40ba374a45b7b7801520d28d2fd14308233cd33ba93943cf1600f7f7f81d032166b1ada5bdd0b4450a139ec1
+c5633deb1fbf020dd6bc03ba8796bd5bd85de50efadc76870c3e5f5cc2b27191bad2a59ea37abb50a96accc373810fa45799d1f60f4dd499637d3eef1f6d8601

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/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/package.json

@@ -1,7 +1,7 @@
 {
   "name": "detox",
   "description": "E2E tests and automation for mobile",
-  "version": "19.10.0",
+  "version": "19.11.0",
   "bin": {
     "detox": "local-cli/cli.js"
   },
@@ -177,5 +177,5 @@
       }
     }
   },
-  "gitHead": "6468b38c68bcac4c283ef005e9817f1d7ba8161b"
+  "gitHead": "900cdb17bd766869cb2d46915ff2c7821808c676"
 }

package/runners/jest-circus/listeners/DetoxCoreListener.js

@@ -22,16 +22,6 @@ class DetoxCoreListener {
     this.detox = detox;
   }
 
-  _getTestInvocations(test) {
-    const { DETOX_RERUN_INDEX } = process.env;
-
-    if (!isNaN(DETOX_RERUN_INDEX)) {
-      return Number(DETOX_RERUN_INDEX) * this._testRunTimes + test.invocations;
-    } else {
-      return test.invocations;
-    }
-  }
-
   async run_describe_start({ describeBlock: { name, children } }) {
     if (children.length) {
       await this.detox[onRunDescribeStart]({ name });
@@ -80,20 +70,39 @@ class DetoxCoreListener {
     this._startedTests.add(test);
 
     await this.detox[onTestStart]({
+      ...this._getTestMetadata(test),
+      status: 'running',
+    });
+  }
+
+  _getTestMetadata(test) {
+    return {
       title: test.name,
+      parent: test.parent.name,
       fullName: getFullTestName(test),
       status: 'running',
+      functionCode: test.fn.toString(),
       invocations: this._getTestInvocations(test),
-    });
+    };
+  }
+
+  _getTestInvocations(test) {
+    const { DETOX_RERUN_INDEX } = process.env;
+
+    if (!isNaN(DETOX_RERUN_INDEX)) {
+      return Number(DETOX_RERUN_INDEX) * this._testRunTimes + test.invocations;
+    } else {
+      return test.invocations;
+    }
   }
 
   async test_done({ test }) {
     if (this._startedTests.has(test)) {
       await this.detox[onTestDone]({
-        title: test.name,
-        fullName: getFullTestName(test),
-        status: test.errors.length ? 'failed' : 'passed',
-        invocations: this._getTestInvocations(test),
+        ...this._getTestMetadata(test),
+        status: _.isEmpty(test.errors) ? 'passed' : 'failed',
+        errors: _.isEmpty(test.errors) ? undefined : test.errors,
+        asyncError: _.isEmpty(test.asyncError) ? undefined : test.asyncError,
         timedOut: hasTimedOut(test)
       });
 

package/src/DetoxExportWrapper.js

@@ -66,7 +66,7 @@ class DetoxExportWrapper {
       }
 
       this[_detox] = new Detox(resolvedConfig);
-      await traceCall('detoxInit', () => this[_detox].init());
+      await traceCall('detoxInit', this[_detox].init());
       Detox.none.setError(null);
 
       return this[_detox];

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();
   }
 }