What's Changed

• fix: find *.cjs configs by @noomorph in https://github.com/wix/Detox/pull/4358

  Adds support for .detoxrc.cjs or detox.config.cjs lookup in projects that use explicit CommonJS file extensions.

Full Changelog: https://github.com/wix/Detox/compare/20.17.0...20.17.1

What's Changed

• Added support for React Native 0.72.x

Full Changelog: https://github.com/wix/Detox/compare/20.16.0...20.17.0

What's Changed?

iOS: Enhanced Device Commands

We're excited to announce the latest updates, focusing on enhancing and fixing device commands for setting permissions and location, with added compliance for iOS 17 (by @asafkorem in https://github.com/wix/Detox/pull/4301).

Fixes:

• Resolved Permission Regressions on iOS 17: This update addresses permission regressions specific to iOS 17.
• Restoration of device.setLocation(lat, lon): The functionality of this method is now restored, resolving issues discussed in ASU Issue #111 and other related issues: [1], [2], [3], [4] and more. For more details on setting location, see the set location documentation.

Features:

• Improved Photos and Contacts Permissions: Introduced support for limited permission settings for photos and contacts. Refer to the launch app permissions documentation for more information.

Migration Notes:

Please upgrade Xcode or Command Line Tools for Xcode to the latest version (15 or newer) for full compatibility with the recent update. You can find the latest Xcode or Command Line Tools for Xcode at Apple Developer Downloads.

Full Changelog: https://github.com/wix/Detox/compare/20.15.0...20.16.0

What's Changed

• Feature: Add start position parameters to scrollTo(edge) action API (by @andrey-wix 👑 in https://github.com/wix/Detox/pull/4309)
  See documentation: scrollTo(edge[, startPositionX, startPositionY])
• Fix (Android): Resolve issue with scrolling on Android API v33-34, avoiding interference with gesture navigation (by @gosha212 🥇 in https://github.com/wix/Detox/pull/4327)

Internal

• Update lerna to latest legacy version by @noomorph in https://github.com/wix/Detox/pull/4325

New Contributors

• @andrey-wix made their first contribution in https://github.com/wix/Detox/pull/4309

Full Changelog: https://github.com/wix/Detox/compare/20.14.8...20.15.0

What's Changed

iOS

Fixed a regression with custom keyboards on iOS 17 (by @asafkorem in https://github.com/wix/Detox/pull/4318).

Full Changelog: https://github.com/wix/Detox/compare/20.14.7...20.14.8

What's Changed

• fix(ios): increase maxBuffer for applesimutils --list by @noomorph in https://github.com/wix/Detox/pull/4315

  This fix may help when you have too many iOS runtimes installed simultaneously.

• chore: update dev dependencies by @noomorph in https://github.com/wix/Detox/pull/4314

Full Changelog: https://github.com/wix/Detox/compare/20.14.6...20.14.7

What's Changed

This is a release with internal changes.

Early adopters of jest-allure2-reporter integration may find this release interesting – please mind that this integration is not supported officially yet (docs are in progress).

• refactor: dynamic device allocation by @noomorph in https://github.com/wix/Detox/pull/4290
• internal(jest): use jest-environment-emit by @noomorph in https://github.com/wix/Detox/pull/4212

Full Changelog: https://github.com/wix/Detox/compare/20.14.5...20.14.6

What's Changed

Android

• Fixed crash caused by new version of Espresso (3.5.1) by @gosha212 in #4305

Full Changelog: https://github.com/wix/Detox/compare/20.14.4...20.14.5

What's Changed

Android

This is a replay of the Android changes made in 20.14.0 (stable, supervised android launch) and were reverted in 20.14.2 -- this time with a fix for the issues described in the PR (@d4vidi in #4303)

Full Changelog: https://github.com/wix/Detox/compare/20.14.3...20.14.4

What's Changed

• fix(android): swipe is not working correctly on API 33-34 by @gosha212 in https://github.com/wix/Detox/pull/4299

New Contributors

• @gosha212 made their first contribution in https://github.com/wix/Detox/pull/4299

Full Changelog: https://github.com/wix/Detox/compare/20.14.2...20.14.3

Temporarily reverts

What's Changed

Android

• Temporarily reverts "Re: Supervised android launch (#4293)" by @d4vidi in #4296, until https://github.com/wix/react-native-navigation/pull/7822 is released

Full Changelog: https://github.com/wix/Detox/compare/20.14.1...20.14.2

What's Changed

This is a technical and boring release where one particular log message in the detox.trace.json artifact is fixed (conflict-free property name, pid -> cpid).

• fix: stop pid override in logs by @noomorph in https://github.com/wix/Detox/pull/4294

Full Changelog: https://github.com/wix/Detox/compare/20.14.0...20.14.1

First release in a while! 🙏🏻

What's Changed

Android improvements

• Reimplement Android lunch sequence in a more stable, supervised way + React markers logging - by @d4vidi in #4293

CLI

• Run test-runner in detached mode - by @noomorph in #4260

Docs Website

• Various improvements by @IrbisKronos in #4246 #4268, @MattFoley in #4283

New Contributors ❤️

• @MattFoley made their first contribution in https://github.com/wix/Detox/pull/4283

Full Changelog: https://github.com/wix/Detox/compare/20.13.5...20.14.0

What's Changed

iOS Fix

• Fix race condition with Reanimated library (by @asafkorem in https://github.com/wix/Detox/pull/4261).

Full Changelog: https://github.com/wix/Detox/compare/20.13.4...20.13.5

What's Changed

• fix(android): Android Gradle Plugin 8 support by @noomorph in https://github.com/wix/Detox/pull/4254
• fix(iOS): update DetoxSync, fix sync issue. by @asafkorem in https://github.com/wix/Detox/pull/4258
  • Taps on a View with RNGH do not work as expected when the app is started with Detox (#4194)

New Contributors

• 🎉 @dyvapandhu made their first contribution in https://github.com/wix/Detox/pull/4256 🎉
  • docs(website): fix outdated sdk and avd manager directories by @dyvapandhu in https://github.com/wix/Detox/pull/4256

Full Changelog: https://github.com/wix/Detox/compare/20.13.3...20.13.4

What's Changed

• fix(android): add namespace to build.gradle for android gradle plugin 8 compatibility by @mikehardy in https://github.com/wix/Detox/pull/4229
• refactor(types): extract globals.d.ts by @noomorph in https://github.com/wix/Detox/pull/4243
• fix(android-web): throw a correct error on invalid arguments by @noomorph in https://github.com/wix/Detox/pull/4243

Full Changelog: https://github.com/wix/Detox/compare/20.13.2...20.13.3

What's Changed

Android fixes

• Open app via URL - Error Due to Unescaped "&" in Command Param (#4196) by @noomorph via https://github.com/wix/Detox/pull/4241
• Scrolling issue (#2787) on Android API 33+ by @patriksletmo via https://github.com/wix/Detox/pull/4225
  although this is only a partial fix, huge and cordial thanks to Patrik !! ❤️ 👏 👏

New contributors

Full Changelog: https://github.com/wix/Detox/compare/20.13.1...20.13.2

What's Changed

Android

• 💥 "Android API 32, 33 (v12): .tap() acts like tap+hold" (#3762) by @ericschaal via #4216

  ⬆️ This fixes an issue with Detox taps mistakenly registered as tap+hold on newer Android API levels (32+).
  Note: While the tapping issue might be resolved with the patch, there's a known issue with scrolling not working as intended on the new Android API. We're looking for the contributors.

• ⚙️ "Something is odd about runScriptWithArgs signature" (#4127) by @noomorph via #4221

  Technically, this fix is a breaking change – it removes the runScriptWithArgs API, but since it never has worked, this should not be an issue. Now, you can use runScript to pass your arguments to the web elements and also get results (provided your function is synchronous):

  const isDisabled = await myWebButton.runScript(btn => btn.disabled);
  await myWebButton.runScript((btn, text) => { btn.textContent = text }, ['New text']);
  

iOS

• Preserve logs after device.resetContentAndSettings() by @noomorph via #4215

  Fixes a rare condition where the artifacts manager breaks down in the subsequent test after using device.resetContentAndSettings() in the previous one.

New Contributors

Thanks, @ericschaal, for your first (and very valuable! 🏆 ) contribution in https://github.com/wix/Detox/pull/4216

Thanks, @IrbisKronos, for your second contribution this year, the new social networks ribbon on the website.

Thanks, @monholm, for a tip on how to list available device specs.

Full Changelog: https://github.com/wix/Detox/compare/20.13.0...20.13.1

What's Changed

This release brings a new device allocation lifecycle (#4173, @noomorph) – the device management moved to the parent process (as opposed to every child (worker) process before). This is a backwards-compatible change for most of the users, but we recommend custom Detox driver maintainers to check for any issues (cc @awinograd).

• Fixed -u, --cleanup option. For example, in Jest, devices used to shut down prematurely after each test file. Now they will only shut down after the entire test session (#2894)
• [Genymotion SaaS] The -R, --retries option functions correctly after initial boot failures (#3655).
• Fixed race conditions when running multiple detox test... commands at once (#3573)

Technical changes

• detox reset-lock-file command is no longer needed for 99.9% of cases
• All the device registries (lock files) have been reduce to a single one
• The cookie object issued by the allocation driver must be a plain serializable object (NB @awinograd), not an instance of a class

Full Changelog: https://github.com/wix/Detox/compare/20.12.2...20.13.0

What's Changed

Fixes

General

• Address jest reporter issue (reported on https://github.com/wix/Detox/discussions/4121) and redundant summary printing (https://github.com/wix/Detox/pull/4199, @noomorph).
• Enhance integration of Jest's --bail, Detox's --retries and related callbacks (https://github.com/wix/Detox/pull/4115, @noomorph).

Android

• Resolve ClassNotFoundException error (reported on https://github.com/wix/Detox/pull/2846) for Material Slider class when calling getAttributes (https://github.com/wix/Detox/pull/4203, @asafkorem).

Internal

• Use Node 16 for local development (https://github.com/wix/Detox/pull/4201, @noomorph).

Full Changelog: https://github.com/wix/Detox/compare/20.12.1...20.12.2