Skip to content

Latest commit

 

History

History
90 lines (56 loc) · 2.48 KB

README.md

File metadata and controls

90 lines (56 loc) · 2.48 KB
Raw

Detox End-To-End Testing

Setup

To get your Detox tests up and running, you'll need to install some global dependencies:

  1. Install the latest version of Homebrew
  2. Make sure you have Node installed (at least 8.6.0). If you don't:

If you use NVM:

nvm install node

Or if you'd prefer to install directly from Homebrew

brew update && brew install node
  1. Install `applesimutils, which will allow Detox to communicate with the iOS simulator:
brew tap wix/brew && brew install applesimutils
  1. Install the Detox CLI
npm install -g detox-cli

Configuring tests

You'll need to set the Detox configuration settings in package.json to run Detox tests on a simulator name + OS version that is installed in your environment.

In Xcode, open Window -> Devices and Simulators Tap the Simulators tab at the top of the modal. On the left hand side of the modal screen, select iPhone 11 (or some other Simulator)

Note the iOS version value displayed on the left hand side below the name of the device being simulated. For example "iOS 13.2.2 (17B102)" This is the value displayed if iPhone 11 is selected in the left hand list under iOS.

Set the iOS value that matches the simulator to be tested in the Detox configuration settings found in the package.json generated for your new project.

Example:

"device": { "name": "iPhone 11", "os": "iOS 13.2" }

Adding tests

We've gotten you started with ./detox/firstTest.spec.js, which tests that the two main example screens render properly using Detox.

Note that in order to pick up elements by ID, we've added the testID prop to the component.

Running tests

  1. Start the packager
yarn start

(Expo-only note: for testing production code, start the packager with yarn start --no-dev --minify)

  1. Run the tests
yarn build:detox
yarn test:detox

or for Expo:

yarn expo:build:detox
yarn expo:test:detox

For more information, make sure to check out the official Detox Docs

Debugging Flaky Detox Tests

To debug and see view hierarchy, run the command with --loglevel verbose.

yarn test:detox --loglevel verbose

You can also read the official recommendations here: https://github.com/wix/Detox/blob/master/docs/Troubleshooting.Flakiness.md