Detox Driver
Drop-in replacement for import { by, element, expect, waitFor, device } from 'detox'.
Your existing Detox specs run against Peach’s canvas with no native build.
Running your suite
You don’t wire this up by hand. peach test runs your own Jest, forcing a
preset that remaps ^detox$ to the Peach driver, so import ... from 'detox'
resolves to Peach without touching your test files:
The driver creates its own browser context. --no-launch skips the
running-shell reachability check; it does not attach to an existing sim.
--app <port|url> names the app each device.launchApp() opens, and
--port picks the bridge, defaulting to the active local one. The runner picks
up config from --config <path>, else peach-detox.config.cjs, any
jest.config.*, or a jest key in package.json, else a generated temp
config. Your Jest version, transforms, and setup files are
preserved.
Matchers
by.id, by.text, and by.label accept strings or regular expressions,
matching Detox 20.47.0 on iOS. Strings match exactly. A regular expression’s
first match must cover the entire value; use .* for partial matching:
The i, m, and s flags are supported. Matching uses Unicode;
g and y are ignored, so repeated lookups do not advance the expression.
A diagnostic such as label == “/sign in/i” describes the regex matcher;
it does not mean the slashes are matched literally.
Element actions
Assertions
toBeFocused checks focus. toHaveSliderPosition and toHaveToggleValue
currently only assert existence.
waitFor
These seven conditions support .not, including text, label, id, value,
and focus. Detox’s aliases (toNotExist, toBeNotVisible, toBeNotFocused,
toNotHaveText, toNotHaveLabel, toNotHaveId, and toNotHaveValue) work
on both expect and waitFor. Repeating .not still negates once, as on iOS.
withTimeout(0) evaluates once. toHaveValue compares the accessibility
value exactly.
Device
No-ops kept for source compatibility (there is no native process in the
browser): installApp, uninstallApp, shake,
setURLBlacklist.