What's Changed

Fixes: Compliance with Xcode 16 and iOS 18

• Added Support for Xcode 16 (beta): added @retroactive for protocol conformance. By @asafkorem in https://github.com/wix/Detox/pull/4520
• Added Support for iOS 18: resolved keyboard error for iOS 18 simulators. By @asafkorem in https://github.com/wix/Detox/pull/4523

Full Changelog: https://github.com/wix/Detox/compare/20.23.0...20.23.1

What's Changed

General

• Troubleshooting Docs: improve Android troubleshooting docs (by @ace-n in https://github.com/wix/Detox/pull/4498)
• Types: Fix getUiDevice() type and docs (by @d4vidi in https://github.com/wix/Detox/pull/4509)

New Features

• iOS: [EXPERIMENTAL] Support interactions with secured web-view elements, see asSecured()API (by @asafkorem in https://github.com/wix/Detox/pull/4505)

New Contributors

• @ace-n made their first contribution in https://github.com/wix/Detox/pull/4498

Full Changelog: https://github.com/wix/Detox/compare/20.22.2...20.23.0

Fixes

• iOS: Fix error with version release packing script (by @asafkorem in https://github.com/wix/Detox/pull/4496)

Full Changelog: https://github.com/wix/Detox/compare/20.22.1...20.22.2

What's Changed

System API (iOS Only)

This version adds support for system-dialogs interaction.

At the moment, System APIs are limited to iOS system dialogs (e.g. permissions, alerts, etc.). We plan to expand the System APIs to include Android support and more system-level interactions, such as OS browser (Safari / Chrome), interactions with push notifications, photo library, etc.

• For more details, check the System API docs.
• See the System API test suite for examples.

[!IMPORTANT]
System APIs are currently in an experimental phase. This means that the API is not yet final and may change over minor releases.

By @asafkorem in https://github.com/wix/Detox/pull/4457.

Full Changelog: https://github.com/wix/Detox/compare/20.21.0...20.22.0

What's Changed

Enhancements

• Add duration and point (optional) parameters for longPress() action on both platforms (by @asafkorem in https://github.com/wix/Detox/pull/4475)

Fixes

• Fix Android scrolling inaccuracy and exception while over-scrolling (by @gosha212 in https://github.com/wix/Detox/pull/4482).
• Fix types of whileElement to be aligned with the documentation, available with scroll only. (by @gosha212 in https://github.com/wix/Detox/pull/4485).

Docs

• Elaborate on test IDs in the test IDs guide: Naming best practices (by @d4vidi in https://github.com/wix/Detox/pull/4487).

Full Changelog: https://github.com/wix/Detox/compare/20.20.3...20.21.0

What's Changed

• Limit ReactNativeMarkers logging to RN ≥71 (@Rolando-Barbella, #4447)

New Contributors

• @Rolando-Barbella made their first contribution!

Full Changelog: https://github.com/wix/Detox/compare/20.20.2...20.20.3

What's Changed

iOS Fix: WebView Support

• Typing issue with React web pages fixed. Corrected a problem where typing events were not properly handled in MUI TextField component. By @asafkorem. See PR #4444 and Issue #4437.

Full Changelog: https://github.com/wix/Detox/compare/20.20.1...20.20.2

What's Changed

iOS Fix: WebView Support

• Avoid automatically moving the cursor to the end on web input elements that lack support for range selection. By @asafkorem in https://github.com/wix/Detox/pull/4442, fixes https://github.com/wix/Detox/issues/4437, https://github.com/wix/Detox/issues/4426.

Full Changelog: https://github.com/wix/Detox/compare/20.20.0...20.20.1

What's Changed

Android Improvements

• Added parity for the element.longPressAndDrag() action, by @gosha212 in https://github.com/wix/Detox/pull/4423

Fixes

• post-install issue for non react native projects by @gosha212 in https://github.com/wix/Detox/pull/4430

Full Changelog: https://github.com/wix/Detox/compare/20.19.5...20.20.0

What's Changed

iOS - Improvements and Fixes

• Simulator (Device) Logs: Now, long device log messages are broken into parts to prevent truncation. By @asafkorem in https://github.com/wix/Detox/pull/4425
• WebView Testing: Implemented a workaround for a selection error on non-text input types. By @asafkorem in https://github.com/wix/Detox/pull/4427
• WebView Testing: Introduced a launch argument to disable WebKit security (detoxDisableWebKitSecurity), enhancing testing capabilities (check our Testing WebViews guide for more details). By @asafkorem in https://github.com/wix/Detox/pull/4429

Full Changelog: https://github.com/wix/Detox/compare/20.19.4...20.19.5

What's Changed

• fix: set required Node.js version to 14.x (via https://github.com/wix/Detox/pull/4422 by @noomorph)

Detox 20.x still supports older versions of Node (down to 14.x), and if you've been getting errors like:

error [email protected]: The engine "node" is incompatible with this module. Expected version ">=18". Got "16.20.2"

...this hotfix should resolve your issue. (i.e., The prior version bump to minimum 18.x+ was unintended.)

Nevertheless, make sure to upgrade your Node.js in time. 😉

Full Changelog: https://github.com/wix/Detox/compare/20.19.3...20.19.4

What's Changed

[!NOTE]
This version introduces several fixes for WebView testing on iOS, following initial feedback on the latest minor release (20.19), where we introduced web APIs on iOS for feature parity with Android. Check our WebView APIs for more information.

iOS Fixes: WebView support

• Inner Frames Interaction: add support for web-view interaction capabilities within inner frames.
• CORS Restrictions Bypass: Implemented a bypass for Cross-Origin Resource Sharing (CORS) restrictions during Detox tests, addressing issues related to inner frames.
• Cursor Position on Typing: resolved an issue to keep the cursor at the end of the text field while typing.

by @asafkorem in https://github.com/wix/Detox/pull/4411

Full Changelog: https://github.com/wix/Detox/compare/20.19.2...20.19.3

What's Changed

iOS

• Fixed an issue where typeText in WebViews ignored input's max-length. by @asafkorem in https://github.com/wix/Detox/pull/4407

Full Changelog: https://github.com/wix/Detox/compare/20.19.1...20.19.2

What's Changed

WebView Testing Support on iOS

We've added support for web-view testing on iOS, achieving feature parity with Android (by @asafkorem in https://github.com/wix/Detox/pull/4394).

Check the updated WebView API docs for more details, and our Testing WebViews guide.

Full Changelog: https://github.com/wix/Detox/compare/20.18.5...20.19.1

What's Changed

• Release legacy aar for Java 11 by @gosha212 in https://github.com/wix/Detox/pull/4390
• Restore RN73 compatibility by @d4vidi in https://github.com/wix/Detox/pull/4381

Full Changelog: https://github.com/wix/Detox/compare/20.18.4...20.18.5

[!IMPORTANT]

Release Note: Update for Detox Users on Java 11

Context: This note is pertinent for Detox users who are currently using Java 11 and are unable to upgrade to Java 17 at this time.

Important Dependency Update for Java 11 Users

For those continuing to use Java 11, it's important to update your Detox dependency in the app/build.gradle file to ensure compatibility.

Update Steps:

• Replace the standard Detox dependency in your build.gradle file:
  com.wix:detox:+
  with the Java 11 compatible version:
  com.wix:detox-legacy:+

What's Changed

Fixes

• iOS: fix segfault with Reanimated in DetoxSync (by @tyronet-sportsbet in https://github.com/wix-incubator/DetoxSync/pull/71, https://github.com/wix/Detox/pull/4387)

Full Changelog: https://github.com/wix/Detox/compare/20.18.3...20.18.4

What's Changed

[!IMPORTANT]
Support for React Native 73 temporarily reverted, due to issue found in environments without Java17. Fixing this is a WIP (@d4vidi, #4380)

Full Changelog: https://github.com/wix/Detox/compare/20.18.2...20.18.3

What's Changed

Enhancements

• Communicate crash errors more clearly by @noomorph in https://github.com/wix/Detox/pull/4376

Fixes

• Genymotion SaaS: Omit preliminary login check by @d4vidi in https://github.com/wix/Detox/pull/4379

Full Changelog: https://github.com/wix/Detox/compare/20.18.1...20.18.2

What's Changed

• fix(ios): track hierarchy artifacts by @noomorph in https://github.com/wix/Detox/pull/4365
• Fixed a broken post install script by @gosha212 in https://github.com/wix/Detox/pull/4369

Full Changelog: https://github.com/wix/Detox/compare/20.18.0...20.18.1

What's Changed

• chore: update Allure integration by @noomorph in https://github.com/wix/Detox/pull/4364
• React Native 73 support by @gosha212 in https://github.com/wix/Detox/pull/4347
• fix: stabilize artifacts flushing by @noomorph in https://github.com/wix/Detox/pull/4367
• Fixed release pipeline by @gosha212 in https://github.com/wix/Detox/pull/4368

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