Added back --args to xcrun simctl launch, was wrongly removed in #2540 (@rotemmiz, #2556)

• Detox by default will be querying the app status (why it is still busy?) if it remains unresponsive for more than 10 seconds (--debug-synchronization 10000) - #2595, @noomorph
• Fix an issue when Detox hangs up after an unsuccessful attempt to allocate a device - #2594, @noomorph

• TypeScript definitions: add typings for DetoxConfig, fix missing global.* properties from Detox (#2591, @noomorph)

• Reworked Android device allocators
• Improved Genymotion-Cloud logging
• Improved --debug-synchronization output for iOS tests

This release repatriates TypeScript definitions from DefinitelyTyped to the official Detox repo. (#2564)

Thanks to:

• Tareq El-Masri
• Jeff Held
• Steve Chun
• Hammad Jutt
• pera
• Max Komarychev
• Christian Bar
• Henrik Raitasola
• dbilgin
• Dor Ben Baruch
• Luis Naranjo
• Martin Treurnicht
• Martin Yrjola
• Nick Pachulski
• Simon Treny
• Wesley Wigham

Fixed crashes with map views on iOS.

Detox now uses a custom synchronization system on iOS, developed in-house; this is the second step in phasing out our Earl Grey usage. We have tested this system extensively internally, and are confident that it should work as expected. There are no known limitations with the new system.

If you are seeing issues with the new sync system, please open an issue.

Important: apps no longer will be launched automatically — use device.launchApp().
See the link below for more details.

⚠️ Full list of breaking changes in the release. ⚠️

There was a release error with 17.14.7. Description here includes changes since 17.14.6

• Improve usability of launch apps manually when running UI tests with Detox (#2540, #2552)
• Fixed time-scale issue with the timeline artifact (#2548).
• Android: Continued work on Genymotion-cloud support (WIP).

Invalid release - error uploading to npm.

Features

• Introducing a more mature* support for the timeline artifact - now with a new Detox tracing API to let developers bundle in their own in-test sections into the output (#2505, #2522, #2531)

* Marked as beta because the API is still subject to breaking changes.

Android

• A minor, yet important, fix: Unrevert omission of call to Genycloud driver's globalCleanup() through Detox' global cleanup (#2529)

Fixed a crash with Google Maps SDK on iOS.

It is an alias for [email protected], due to the unsuccessful npm publish step execution in CI.

• Fixed a crash where text object was of an unexpected class (#2500, by @LeoNatan)
• Improved log level checking (#2506, by @noomorph)

Detox now supports Apple Silicon/m1 machines.

Hotfixes

• fix(artifacts): always loglevel=trace for log artifacts (#2482)

Android fixes:

• Fix attached-android device usage regression #2479 - (fixes #2478)

Features

• element.swipe() signature has been extended (#2432 by @LeoNatan, @noomorph)

/*
 * @param {'up' | 'down' | 'left' | 'right'} direction - direction to swipe
 * @param {'fast' | 'slow'} [speed] - swipe speed
 * @param {number} [normalizedSwipeOffset] - swipe amount relative to the screen width/height
 * @param {number} [normalizedStartingPointX] - X coordinate of swipe starting point, relative to the view width
 * @param {number} [normalizedStartingPointY] - Y coordinate of swipe starting point, relative to the view height
 */
function swipe(
  direction,
  speed = 'fast',
  normalizedSwipeOffset = NaN, // NaN - use optimal value by default
  normalizedStartingPointX = NaN, // NaN - use optimal value by default
  normalizedStartingPointY = NaN // NaN - use optimal value by default
) {}

Usage:

await element(by.id('someScrollView')).swipe('up');
await element(by.id('someScrollView')).swipe('down', 'slow');
await element(by.id('someScrollView')).swipe('left', 'fast', 0.95);
await element(by.id('someScrollView')).swipe('right', 'slow', NaN, 0.3);
await element(by.id('someScrollView')).swipe('up', 'fast', undefined, 0.5, 0.95);

Added support for matching and interacting with accessibility elements on iOS. Stuff like SwiftUI Text and Image should now be matched and interacted with.

• fix(android): respect --headless option when getting emulator version (#2451, by @mmusil)