detox 20.0.14-next-is-hittable-check-2.0 → 20.0.15-prerelease.0

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

@@ -0,0 +1 @@
+ef866445bee1b7191de4336c76dd93f9

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

@@ -0,0 +1 @@
+3d69a7ece65dfc290ba7c7a71d7e76227353d86f

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

@@ -0,0 +1 @@
+d34810beb66a73776549bfa5f5c2eefc40250584f69bf471612403f18ea8b518

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

@@ -0,0 +1 @@
+c59585aa86f4995c6873ae6fc086b882076b6c3a655388515abcacbadb3dbddd46712869703619e903dff89c466ed080634e113b3a480465fa27ec3edde08d7a

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

@@ -0,0 +1 @@
+ff0f0578be190c91b57c6024df4b5fb6

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

@@ -0,0 +1 @@
+8cc49ca4de60598d65767133544f0bd6ad97b494

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

@@ -0,0 +1 @@
+5ad08ad6fb9c09f1391a326d24d96b939ca8cde038f78dbc7ff0a4604e27f3b0

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

@@ -0,0 +1 @@
+403e4e5b90acce7b564bb73213361df77e3e226a36465c7308875a7511e6c8794ab22c8cbd3580eb439798b0245d4a54be94e818a08ffa5125bc85913e802f94

package/Detox-android/com/wix/detox/{20.0.14-next-is-hittable-check-2.0/detox-20.0.14-next-is-hittable-check-2.0.pom → 20.0.15-prerelease.0/detox-20.0.15-prerelease.0.pom}

@@ -3,7 +3,7 @@
   <modelVersion>4.0.0</modelVersion>
   <groupId>com.wix</groupId>
   <artifactId>detox</artifactId>
-  <version>20.0.14-next-is-hittable-check-2.0</version>
+  <version>20.0.15-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.15-prerelease.0/detox-20.0.15-prerelease.0.pom.md5

@@ -0,0 +1 @@
+8c1df15d68775116019b04b9496a6ff6

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

@@ -0,0 +1 @@
+dbe3d335c31886336e6c969b38e222d6f92004da

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

@@ -0,0 +1 @@
+4ec36429edce121f9a29981a67b9ea84bce00e7c4991bd6d1636c8edb0d3b322

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

@@ -0,0 +1 @@
+c4b645ab10c009733624a5aebb04c701a0b73e22dc419b3ba5a396d6937bad9d26e1ae7d9c4057bfc5d915b4af91250af6c5b991535b8554ba1d80abb3990b10

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

@@ -3,11 +3,11 @@
   <groupId>com.wix</groupId>
   <artifactId>detox</artifactId>
   <versioning>
-    <latest>20.0.14-next-is-hittable-check-2.0</latest>
-    <release>20.0.14-next-is-hittable-check-2.0</release>
+    <latest>20.0.15-prerelease.0</latest>
+    <release>20.0.15-prerelease.0</release>
     <versions>
-      <version>20.0.14-next-is-hittable-check-2.0</version>
+      <version>20.0.15-prerelease.0</version>
     </versions>
-    <lastUpdated>20221102074725</lastUpdated>
+    <lastUpdated>20221110171141</lastUpdated>
   </versioning>
 </metadata>

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

@@ -1 +1 @@
-a1b9fb9ca9d07b3262312c77cbff61fb
+0a8740dfdf732622e512707d164837bc

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

@@ -1 +1 @@
-e8e44759632af3d4984893f4a28563aea9527f22
+f892f8ff0cda46b0e16a893224d340c1e3d2c803

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

@@ -1 +1 @@
-ae7d117aa6790de1a9487a514d0cf8244edb3885b266cc06030c77f14feb86ff
+9ed56153c167d071db724c68d6e141358916df50340cf29bb3ff23ea8db43091

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

@@ -1 +1 @@
-d256253b0492f63eda88eebb21a54e0ee3d73ab7420ff1db8e766ef09f49d8c854e4054358a0ad0d539380faa918ac0334405977c1e73126f00f6e939e4cb9da
+13e2b660cbe1403226c025fe83ebb5f8c9f28de41fd432bcc355a9b42562e9158e68c161b6cf801f45c9878565d46beb7884b5b62d6ace714e36d06d17a1d1e3

package/index.d.ts

@@ -82,7 +82,7 @@ declare global {
                  */
                 exposeGlobals?: boolean;
                 /**
-                 * By default, Detox will uninstall and install the app upon the initialization.
+                 * By default, Detox will uninstall and install the app upon initialization.
                  * If you wish to reuse the existing app for a faster run, set the property to
                  * `false`.
                  */
@@ -408,8 +408,6 @@ declare global {
             os: string;
         }
 
-        type DetoxKnownDeviceType = DetoxBuiltInDeviceConfig['type'];
-
         type DetoxConfiguration = DetoxConfigurationCommon & (
             | DetoxConfigurationSingleApp
             | DetoxConfigurationMultiApps
@@ -474,8 +472,6 @@ declare global {
                 readonly startSection: (name: string) => void;
                 /** @deprecated */
                 readonly endSection: (name: string) => void;
-                /** @private */
-                readonly invocationCall: (...args: unknown[]) => unknown;
             };
 
             /**
@@ -683,10 +679,11 @@ declare global {
              * Relaunch the app. Convenience method that calls {@link Device#launchApp}
              * with { newInstance: true } override.
              *
+             * @deprecated
              * @param config
              * @see Device#launchApp
              */
-            relaunchApp(config?: Omit<DeviceLaunchAppConfig, 'newInstance'>): Promise<void>;
+            relaunchApp(config?: DeviceLaunchAppConfig): Promise<void>;
 
             /**
              * Access the user-defined launch-arguments predefined through static scopes such as the Detox configuration file and

package/internals.d.ts

@@ -13,28 +13,36 @@ declare global {
       resolveConfig(options?: Partial<DetoxInitOptions>): Promise<RuntimeConfig>;
 
       /**
+       * Returns one of statuses depending on what’s going with the current Detox context:
        *
+       * `inactive` – before `init()` and after `cleanup()` is called.
+       * `init` – while `init()` is executing.
+       * `active` – after `init()` and before `cleanup()` is called.
+       * `cleanup` – while `cleanup()` is executing.
        */
       getStatus(): DetoxStatus;
 
       /**
-       * This is the phase where Detox reads its configuration, starts a server.
+       * Starts a new Detox test session with the provided configuration.
+       * See {@link https://wix.github.io/Detox/docs/next/api/internals} for more details.
        */
       init(options?: Partial<DetoxInitOptions>): Promise<void>;
 
       /**
-       * This is the phase where Detox loads its expectation library and starts a device.
+       * This is the phase where Detox loads its expectation library and boots a device.
+       * You don't need to call it separately unless you use `init({ workerId: null })` override.
        */
       installWorker(options?: Partial<DetoxInstallWorkerOptions>): Promise<void>;
 
       /**
        * Deallocates the device.
+       * Most Client API (device, by, element, expect) will stop working, except for the logger.
        */
       uninstallWorker(): Promise<void>;
 
       /**
-       * The global cleanup phase should happen after all the tests have finished.
-       * This is the phase where the Detox server shuts down.
+       * This method should be called when the main or child process is about to exit.
+       * See {@link https://wix.github.io/Detox/docs/next/api/internals} for more details.
        */
       cleanup(): Promise<void>;
       //#endregion
@@ -234,7 +242,7 @@ declare global {
        * or equal to "default" if the name is not configured.
        */
       apps: Record<string, Readonly<Detox.DetoxAppConfig>>;
-      artifacts: Readonly<Detox.DetoxArtifactsConfig>;
+      artifacts: Readonly<RuntimeArtifactsConfig>;
       behavior: Readonly<Detox.DetoxBehaviorConfig>;
       cli: Readonly<CLIConfig>;
       device: Readonly<Detox.DetoxDeviceConfig>;
@@ -243,6 +251,19 @@ declare global {
       session: Readonly<Detox.DetoxSessionConfig>;
     }>;
 
+    type RuntimeArtifactsConfig = {
+      rootDir: string;
+      pathBuilder: string;
+      plugins: Readonly<{
+        log: Readonly<Detox.DetoxLogArtifactsPluginConfig>;
+        screenshot: Readonly<Detox.DetoxScreenshotArtifactsPluginConfig>;
+        video: Readonly<Detox.DetoxVideoArtifactsPluginConfig>;
+        instruments: Readonly<Detox.DetoxInstrumentsArtifactsPluginConfig>;
+        uiHierarchy: Readonly<Detox.DetoxUIHierarchyArtifactsPluginConfig>;
+        [pluginId: string]: unknown;
+      }>;
+    };
+
     type CLIConfig = Readonly<Partial<{
       appLaunchArgs: string;
       artifactsLocation: string;

package/local-cli/cli.js

@@ -30,7 +30,7 @@ yargs
     if (err) {
       logger.error(DetoxError.format(err));
       // eslint-disable-next-line no-console
-      console.error('');
+      process.stderr.write('\n');
       // @ts-ignore
       _.attempt(() => fs.unlinkSync(logger.file));
       // eslint-disable-next-line no-process-exit

package/local-cli/init.js

@@ -9,7 +9,7 @@ const jestTemplates = require('./templates/jest');
 let exitCode = 0;
 
 module.exports.command = 'init';
-module.exports.desc = 'Scaffold initial E2E test folder structure for Detox';
+module.exports.desc = 'Creates template files to get you started with Detox';
 module.exports.builder = {};
 
 module.exports.handler = async function init() {

package/local-cli/test.js

@@ -3,7 +3,7 @@ const detox = require('../internals');
 const TestRunnerCommand = require('./testCommand/TestRunnerCommand');
 
 module.exports.command = 'test';
-module.exports.desc = 'Run your test suite with the test runner specified in package.json';
+module.exports.desc = 'Run your test suites with the test runner specified in the project\'s Detox config';
 module.exports.builder = require('./testCommand/builder');
 module.exports.middlewares = require('./testCommand/middlewares').default;
 
@@ -16,14 +16,14 @@ module.exports.handler = async function test({ detoxArgs, runnerArgs }) {
     };
 
     const config = await detox.resolveConfig(opts);
-    if (!detoxArgs['inspect-brk']) {
+    if (!config.cli.inspectBrk) {
       await detox.init(opts);
     }
 
-    const runnerCommand = new TestRunnerCommand()
-      .setDeviceConfig(config.device)
-      .replicateCLIConfig(config.cli)
-      .setRunnerConfig(config.testRunner);
+    const runnerCommand = new TestRunnerCommand({
+      config,
+      env: process.env,
+    });
 
     await runnerCommand.execute();
   } finally {

package/local-cli/test.test.js

@@ -12,6 +12,7 @@ const cp = require('child_process');
 const cpSpawn = cp.spawn;
 const os = require('os');
 const path = require('path');
+const util = require('util');
 
 const fs = require('fs-extra');
 const _ = require('lodash');
@@ -107,22 +108,49 @@ describe('CLI', () => {
   ])('given no extra args (%s)', (_platform, deviceType) => {
     beforeEach(async () => {
       singleConfig().device.type = deviceType;
-      await run();
     });
 
-    test('should produce a default command', () => {
-      expect(cliCall().argv).toEqual([expect.stringContaining('executable'), '--config', 'e2e/config.json']);
-    });
+    describe('when testRunner.forwardEnv is true', () => {
+      beforeEach(async () => {
+        singleConfig().testRunner = { forwardEnv: true };
+        await run();
+      });
+
+      test('should produce a default command', () => {
+        expect(cliCall().argv).toEqual([expect.stringContaining('executable'), '--config', 'e2e/config.json']);
+      });
 
-    test('should not override environment variables', () => {
-      expect(cliCall().env).toEqual({
-        DETOX_CONFIG_PATH: expect.any(String),
-        DETOX_CONFIG_SNAPSHOT_PATH: expect.any(String)
+      test('should override environment variables', () => {
+        expect(cliCall().env).toEqual({
+          DETOX_CONFIG_PATH: expect.any(String),
+          DETOX_CONFIG_SNAPSHOT_PATH: expect.any(String)
+        });
+      });
+
+      test('should hint essential environment variables', () => {
+        expect(cliCall().fullCommand).toMatch(/\bDETOX_CONFIG_PATH=.*\bexecutable\b/);
       });
     });
 
-    test('should hint essential environment variables', () => {
-      expect(cliCall().fullCommand).toMatch(/\bDETOX_CONFIG_PATH=.*\bexecutable\b/);
+    describe('when testRunner.forwardEnv is false', () => {
+      beforeEach(async () => {
+        singleConfig().testRunner = { forwardEnv: false };
+        await run();
+      });
+
+      test('should produce a default command', () => {
+        expect(cliCall().argv).toEqual([expect.stringContaining('executable'), '--config', 'e2e/config.json']);
+      });
+
+      test('should not override environment variables', () => {
+        expect(cliCall().env).toEqual({
+          DETOX_CONFIG_SNAPSHOT_PATH: expect.any(String)
+        });
+      });
+
+      test('should not hint essential environment variables', () => {
+        expect(cliCall().fullCommand).not.toMatch(/\bDETOX_CONFIG_PATH=.*\bexecutable\b/);
+      });
     });
   });
 
@@ -327,13 +355,6 @@ describe('CLI', () => {
     expect(logger().warn).not.toHaveBeenCalledWith(DEVICE_LAUNCH_ARGS_DEPRECATION);
   });
 
-  test('--device-launch-args should serve as a deprecated alias to --device-boot-args', async () => {
-    await run(`--device-launch-args="--verbose"`);
-    expect(cliCall().env).toHaveProperty('DETOX_DEVICE_BOOT_ARGS');
-    expect(cliCall().fullCommand).toMatch(/\bDETOX_DEVICE_BOOT_ARGS="--verbose" /);
-    expect(logger().warn).toHaveBeenCalledWith(DEVICE_LAUNCH_ARGS_DEPRECATION);
-  });
-
   test('--app-launch-args should be passed as an environment variable', async () => {
     await run(`--app-launch-args="--debug yes"`);
     expect(cliCall().env).toHaveProperty('DETOX_APP_LAUNCH_ARGS');
@@ -374,8 +395,6 @@ describe('CLI', () => {
     expect(cliCall().argv.slice(-2)).toEqual(['e2e/01.sanity.test.js', 'e2e/02.sanity.test.js']);
   });
 
-  test.todo('--inspect-brk should work');
-
   test.each([
     ['-d e2eFolder', / e2eFolder$/, /\bDETOX_DEBUG_SYNCHRONIZATION=3000/],
     ['--debug-synchronization e2eFolder', / e2eFolder$/, /\bDETOX_DEBUG_SYNCHRONIZATION=3000/],
@@ -453,15 +472,14 @@ describe('CLI', () => {
     expect(cliCall().argv).toContain('--deepParameter');
   });
 
-  // TODO: revive this test
-  test.skip('--inspect-brk should prepend "node --inspect-brk" to the command', async () => {
-    await run('--inspect-brk');
+  test('--inspect-brk should activate inspectBrk hook', async () => {
+    detoxConfig.testRunner.inspectBrk = (config) => {
+      config.args.customFlag = true;
+      return config;
+    };
 
-    if (process.platform === 'win32') {
-      expect(cliCall().argv).toMatch(/^node --inspect-brk \.\/node_modules\/jest\/bin\/jest\.js/);
-    } else {
-      expect(cliCall().argv).toMatch(/^node --inspect-brk \.\/node_modules\/\.bin\/jest/);
-    }
+    await run('--inspect-brk');
+    expect(cliCall().argv).toContain('--customFlag');
   });
 
   test('should append $DETOX_ARGV_OVERRIDE to detox test ... command and print a warning', async () => {
@@ -477,6 +495,16 @@ describe('CLI', () => {
     expect(logger().warn).toHaveBeenCalledWith(expect.stringContaining('$DETOX_ARGV_OVERRIDE is detected'));
   });
 
+  test('should append $DETOX_ARGV_OVERRIDE "--" part to test runner command', async () => {
+    process.env.PLATFORM = 'ios';
+    process.env.DETOX_ARGV_OVERRIDE = '-- --help';
+
+    await run();
+
+    expect(cliCall().argv.slice(-1)).toEqual(['--help']);
+    expect(logger().warn).toHaveBeenCalledWith(expect.stringContaining('$DETOX_ARGV_OVERRIDE is detected'));
+  });
+
   // Helpers
 
   function tempfile(extension, content) {
@@ -531,7 +559,12 @@ describe('CLI', () => {
   }
 
   async function run(...args) {
-    detoxConfigPath = tempfile('.json', JSON.stringify(detoxConfig));
+    let contents = `module.exports = ${util.inspect(detoxConfig, { depth: Infinity })};`;
+    if (detoxConfig.testRunner && detoxConfig.testRunner.inspectBrk) {
+      contents = contents.replace(/\[Function.*\]/m, detoxConfig.testRunner.inspectBrk.toString());
+    }
+
+    detoxConfigPath = tempfile('.js', contents);
     const __configPath = Math.random() > 0.5 ? '-C' : '--config-path';
     return runRaw('test', __configPath, detoxConfigPath, ...args);
   }

package/local-cli/testCommand/TestRunnerCommand.js

@@ -11,98 +11,33 @@ const { printEnvironmentVariables, prependNodeModulesBinToPATH } = require('../.
 const { escapeSpaces } = require('../../src/utils/shellUtils');
 
 class TestRunnerCommand {
-  constructor() {
-    this._argv = {};
-    this._cli2env = {};
-    this._envHint = {};
+  /*
+    @param {object} opts
+    @param {DetoxInternals.RuntimeConfig} opts.config
+    @param {ProcessEnv} opts.env
+  */
+  constructor(opts) {
+    const cliConfig = opts.config.cli;
+    const deviceConfig = opts.config.device;
+    const runnerConfig = opts.config.testRunner;
+
+    this._argv = runnerConfig.args;
+    this._retries = runnerConfig.retries;
+    this._envHint = this._buildEnvHint(opts.env);
     this._envFwd = {};
-    this._retries = 0;
-    /** @type {Detox.DetoxDeviceConfig} */
-    this._deviceConfig = null;
-  }
-
-  /**
-   * @param {Partial<Readonly<DetoxInternals.CLIConfig>>} cliConfig
-   * @returns {this}
-   */
-  replicateCLIConfig(cliConfig) {
-    this._cli2env = _.omitBy({
-      DETOX_APP_LAUNCH_ARGS: cliConfig.appLaunchArgs,
-      DETOX_ARTIFACTS_LOCATION: cliConfig.artifactsLocation,
-      DETOX_CAPTURE_VIEW_HIERARCHY: cliConfig.captureViewHierarchy,
-      DETOX_CLEANUP: cliConfig.cleanup,
-      DETOX_CONFIGURATION: cliConfig.configuration,
-      DETOX_CONFIG_PATH: cliConfig.configPath,
-      DETOX_DEBUG_SYNCHRONIZATION: cliConfig.debugSynchronization,
-      DETOX_DEVICE_BOOT_ARGS: cliConfig.deviceBootArgs,
-      DETOX_DEVICE_NAME: cliConfig.deviceName,
-      DETOX_FORCE_ADB_INSTALL: this._deviceConfig.type.startsWith('android.')
-        ? cliConfig.forceAdbInstall
-        : undefined,
-      DETOX_GPU: cliConfig.gpu,
-      DETOX_HEADLESS: cliConfig.headless,
-      DETOX_KEEP_LOCKFILE: cliConfig.keepLockFile,
-      DETOX_LOGLEVEL: cliConfig.loglevel,
-      DETOX_READ_ONLY_EMU: cliConfig.readonlyEmu,
-      DETOX_RECORD_LOGS: cliConfig.recordLogs,
-      DETOX_RECORD_PERFORMANCE: cliConfig.recordPerformance,
-      DETOX_RECORD_VIDEOS: cliConfig.recordVideos,
-      DETOX_REPORT_SPECS: cliConfig.jestReportSpecs,
-      DETOX_RETRIES: cliConfig.retries,
-      DETOX_REUSE: cliConfig.reuse,
-      DETOX_TAKE_SCREENSHOTS: cliConfig.takeScreenshots,
-      DETOX_USE_CUSTOM_LOGGER: cliConfig.useCustomLogger,
-    }, _.isUndefined);
-
-    this._envHint = _(process.env)
-      .mapKeys((_value, key) => key.toUpperCase())
-      .pickBy((_value, key) => key.startsWith('DETOX_'))
-      .omit(['DETOX_CONFIG_SNAPSHOT_PATH'])
-      .value();
-
-    return this;
-  }
-
-  /**
-   * @param {Detox.DetoxDeviceConfig} config
-   * @returns {this}
-   */
-  setDeviceConfig(config) {
-    this._deviceConfig = config;
-
-    return this;
-  }
-
-  /**
-   * @param {Detox.DetoxTestRunnerConfig} config
-   * @returns {this}
-   */
-  setRunnerConfig(config) {
-    this._argv = config.args;
-    this._retries = config.inspectBrk ? 0 : config.retries;
-    if (config.forwardEnv) {
-      this._envFwd = this._cli2env;
-      Object.assign(this._envHint, this._cli2env);
+    if (runnerConfig.forwardEnv) {
+      this._envFwd = this._buildEnvOverride(cliConfig, deviceConfig);
+      Object.assign(this._envHint, this._envFwd);
     }
-
-    return this;
   }
 
   async execute() {
     let runsLeft = 1 + this._retries;
-    let launchError;
+    let launchError = null;
 
     do {
       try {
-        if (launchError) {
-          const list = this._argv._.map((file, index) => `  ${index + 1}. ${file}`).join('\n');
-          log.error(
-            `There were failing tests in the following files:\n${list}\n\n` +
-            'Detox CLI is going to restart the test runner with those files...\n'
-          );
-        }
-
-        await this._doExecute();
+        await this._spawnTestRunner();
         launchError = null;
       } catch (e) {
         launchError = e;
@@ -120,9 +55,10 @@ class TestRunnerCommand {
         }
 
         if (--runsLeft > 0) {
-          this._argv._ = testFilesToRetry;
           // @ts-ignore
-          detox.session.testSessionIndex++; // it is always a primary context, so we can update it
+          detox.session.testSessionIndex++; // it is always the primary context, so we can update it
+          this._argv._ = testFilesToRetry;
+          this._logRelaunchError();
         }
       }
     } while (launchError && runsLeft > 0);
@@ -132,7 +68,49 @@ class TestRunnerCommand {
     }
   }
 
-  async _doExecute() {
+  _buildEnvHint(env) {
+    return _(env)
+      .mapKeys((_value, key) => key.toUpperCase())
+      .pickBy((_value, key) => key.startsWith('DETOX_'))
+      .omit(['DETOX_CONFIG_SNAPSHOT_PATH'])
+      .value();
+  }
+
+  /**
+   * @param {DetoxInternals.CLIConfig} cliConfig
+   * @param {Detox.DetoxDeviceConfig} deviceConfig
+   */
+  _buildEnvOverride(cliConfig, deviceConfig) {
+    return _.omitBy({
+      DETOX_APP_LAUNCH_ARGS: cliConfig.appLaunchArgs,
+      DETOX_ARTIFACTS_LOCATION: cliConfig.artifactsLocation,
+      DETOX_CAPTURE_VIEW_HIERARCHY: cliConfig.captureViewHierarchy,
+      DETOX_CLEANUP: cliConfig.cleanup,
+      DETOX_CONFIGURATION: cliConfig.configuration,
+      DETOX_CONFIG_PATH: cliConfig.configPath,
+      DETOX_DEBUG_SYNCHRONIZATION: cliConfig.debugSynchronization,
+      DETOX_DEVICE_BOOT_ARGS: cliConfig.deviceBootArgs,
+      DETOX_DEVICE_NAME: cliConfig.deviceName,
+      DETOX_FORCE_ADB_INSTALL: deviceConfig.type.startsWith('android.')
+        ? cliConfig.forceAdbInstall
+        : undefined,
+      DETOX_GPU: cliConfig.gpu,
+      DETOX_HEADLESS: cliConfig.headless,
+      DETOX_KEEP_LOCKFILE: cliConfig.keepLockFile,
+      DETOX_LOGLEVEL: cliConfig.loglevel,
+      DETOX_READ_ONLY_EMU: cliConfig.readonlyEmu,
+      DETOX_RECORD_LOGS: cliConfig.recordLogs,
+      DETOX_RECORD_PERFORMANCE: cliConfig.recordPerformance,
+      DETOX_RECORD_VIDEOS: cliConfig.recordVideos,
+      DETOX_REPORT_SPECS: cliConfig.jestReportSpecs,
+      DETOX_RETRIES: cliConfig.retries,
+      DETOX_REUSE: cliConfig.reuse,
+      DETOX_TAKE_SCREENSHOTS: cliConfig.takeScreenshots,
+      DETOX_USE_CUSTOM_LOGGER: cliConfig.useCustomLogger,
+    }, _.isUndefined);
+  }
+
+  async _spawnTestRunner() {
     const fullCommand = this._buildSpawnArguments().map(escapeSpaces);
     const fullCommandWithHint = printEnvironmentVariables(this._envHint) + fullCommand.join(' ');
 
@@ -149,7 +127,7 @@ class TestRunnerCommand {
           .tap(prependNodeModulesBinToPATH)
           .value()
       })
-        .on('error', (err) => reject(err))
+        .on('error', /* istanbul ignore next */ (err) => reject(err))
         .on('exit', (code) => code === 0
           ? resolve()
           : reject(new DetoxRuntimeError(`Command failed with exit code = ${code}:\n${fullCommandWithHint}`)
@@ -158,6 +136,7 @@ class TestRunnerCommand {
   }
 
   _buildSpawnArguments() {
+    /* istanbul ignore next */
     const { _: specs = [], '--': passthrough = [], $0, ...argv } = this._argv;
     const { _: $0_, ...$0argv } = parser($0);
 
@@ -168,6 +147,17 @@ class TestRunnerCommand {
       ...unparse({ _: [...passthrough, ...specs] }),
     ].map(String);
   }
+
+  _logRelaunchError() {
+    const list = this._argv._.map((file, index) => {
+      return `  ${index + 1}. ${file}`;
+    }).join('\n');
+
+    log.error(
+      `There were failing tests in the following files:\n${list}\n\n` +
+      'Detox CLI is going to restart the test runner with those files...\n'
+    );
+  }
 }
 
 module.exports = TestRunnerCommand;

package/local-cli/testCommand/builder.js

@@ -109,7 +109,6 @@ module.exports = {
     describe: 'Override the device name specified in a configuration. Useful for running a single build configuration on multiple devices.',
   },
   'device-boot-args': {
-    alias: 'device-launch-args',
     group: 'Execution:',
     describe: 'Custom arguments to pass (through) onto the device (emulator/simulator) binary when booted.',
   },