assertVisually

Same shape as 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.

Shorthand

Condition as a single string.

- assertVisually: the cart shows a red error banner above the checkout button

Examples

- assertVisually:
    that: The dashboard chart is visible and not cut off
    timeout: 10000 # poll for up to 10s before failing

Overview

AI

Interactions

Device

Apps

Screen checks

Element checks

Visual

Network

Scripts

Files

Waits

Control flow

Debugging

Parameters

Shorthand

Examples

​Parameters

​Shorthand

​Examples

​Related

Parameters

Shorthand

Examples

Related