Skip to content

Latest commit

 

History

History
219 lines (164 loc) · 7.96 KB

APIRef.DeviceObjectAPI.md

File metadata and controls

219 lines (164 loc) · 7.96 KB
Raw
id title
APIRef.DeviceObjectAPI
The `device` Object

device is globally available in every test file, it enables control over the current attached device (currently only simulators are supported).

Methods

device.launchApp(params)

Launch the app defined in the current configuration.

Options:

1. Restart the app

Terminate the app and launch it again. If set to false, the simulator will try to bring app from background, if the app isn't running, it will launch a new instance. default is false

await device.launchApp({newInstance: true});
2. Set runtime permissions

Grant or deny runtime permissions for your application.

await device.launchApp({permissions: {calendar: 'YES'}});

Detox uses AppleSimUtils on iOS to support this functionality. Read about the different types of permissions and how to set them in AppleSimUtils' Readme. Check out Detox's own test suite

3. Launch from URL

Mock opening the app from URL to test your app's deep link handling mechanism.

await device.launchApp({url: url});
Mock opening from a URL when app is not running
await device.launchApp({url: url, newInstance: true});

This will launch a new instance of the app and handle the deep link.

Mock opening from a URL when app is in background
await device.launchApp({url: url, newInstance: false});

This will launch the app from background and handle the deep link.

Read more in Mocking Open From URL section.

4. Launch from user notifications
await device.launchApp({userNotification: notification});
Mock receiving a notifications when app is not running
await device.launchApp({userNotification: notification, newInstance: true});

This will launch a new instance of the app and handle the notification.

Mock receiving a notifications when app is in background
await device.launchApp({userNotification: notification, newInstance: false});

This will launch the app from background and handle the notification.

Read more in Mocking User Notifications section.

5. Launch into a fresh installation

A flag that enables relaunching into a fresh installation of the app (it will uninstall and install the binary again), default is false.

await device.launchApp({delete: true});
6. Additional launch arguments

Detox can start the app with additional launch arguments

await device.launchApp({launchArgs: {arg1: 1, arg2: "2"}});

The added launchArgs will be passed through the launch command to the device and be accessible via [[NSProcessInfo processInfo] arguments]

device.relaunchApp(params)

Deprecated Use device.launchApp(params) instead. This method is now calling launchApp({newInstance: true}) for backwards compatibility, it will be removed in Detox 6.X.X.
Kill and relaunch the app defined in the current configuration.

device.terminateApp()

By default, terminateApp() with no params will terminate the app file defined in the current configuration.

To terminate another app, specify its bundle id

await device.terminateApp('other.bundle.id');

device.sendToHome()

Send application to background by bringing com.apple.springboard to the foreground.
Combining sendToHome() with launchApp({newInstance: false}) will simulate app coming back from background.
Check out Detox's own test suite

await device.sendToHome();
await device.launchApp({newInstance: false});
// app returned from background, do stuff

Check out Detox's own test suite

device.reloadReactNative()

If this is a react native app, reload react native JS bundle. This action is much faster than device.relaunchApp(), and is recommended if you just need to reset your react native logic.

device.installApp()

By default, installApp() with no params will install the app file defined in the current configuration.

To install another app, specify its path

await device.installApp('path/to/other/app');

device.uninstallApp()

By default, uninstallApp() with no params will uninstall the app defined in the current configuration.

To uninstall another app, specify its bundle id

await device.installApp('other.bundle.id');

device.openURL({url, sourceApp[optional]})

Mock opening the app from URL. sourceApp is an optional parameter to specify source application bundle id.
Read more in Mocking Open From URL section.
Check out Detox's own test suite

device.sendUserNotification(params)

Mock handling of received user notification when app is in foreground.
Read more in Mocking User Notifications section.
Check out Detox's own test suite

device.setOrientation(orientation)

Takes "portrait" or "landscape" and rotates the device to the given orientation. Currently only available in the iOS Simulator.
Check out Detox's own test suite

device.setLocation(lat, lon)

Note: setLocation is dependent on fbsimctl. if fbsimctl is not installed, the command will fail, asking for it to be installed. Sets the simulator location to the given latitude and longitude.

await device.setLocation(32.0853, 34.7818);

device.setURLBlacklist([urls])

Disable EarlGrey's network synchronization mechanism on preffered endpoints. Usful if you want to on skip over synchronizing on certain URLs.

await device.setURLBlacklist(['.*127.0.0.1.*']);
await device.setURLBlacklist(['.*my.ignored.endpoint.*']);

device.enableSynchronization()

Enable EarlGrey's synchronization mechanism (enabled by default). This is being reset on every new instance of the app.

await device.enableSynchronization();

device.disableSynchronization()

Disable EarlGrey's synchronization mechanism (enabled by default) This is being reset on every new instance of the app.

await device.disableSynchronization();

device.resetContentAndSettings()

Resets the Simulator to clean state (like the Simulator > Reset Content and Settings... menu item), especially removing previously set permissions.

await device.resetContentAndSettings();

device.getPlatform()

Returns the current device, ios or android.

if (device.getPlatform() === 'ios') {
  await expect(loopSwitch).toHaveValue('1');
}