assert, but the agent
reasons over the screenshot rather than the accessibility/XML hierarchy. Reach
for it when the screen is rendered in a way the hierarchy cannot describe (for
example a WebView with multiple pages) or when the condition is purely visual,
such as color, layout, icons, or charts. The simplified form takes the condition
as a single string.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
that | string | Yes | What must be true on the screen, purely from the screenshot. |
timeout | number | No | Milliseconds to wait for the condition to become true. |
saveAs | string | No | Variable to store this step’s return value on env.<name>. |
retries | number | No | Times to retry the step on failure before failing the test. |
skipped | boolean | No | Skip this step at execution time. |