Skip to main content
Same shape as assert, but the agent reasons over the screenshot rather than the DOM. Use this when the property under test is purely visual, such as color, layout, icons, or charts.

​
Parameters

ParameterTypeRequiredDescription
thatstringYesWhat must be true on the page, purely from the screenshot.
timeoutnumberNoMaximum time in milliseconds to wait.
iframestringNoURL or URL pattern of the iframe that contains the target element.
saveAsstringNoName of the variable to write this step’s return value to.
retriesnumberNoNumber of times to retry the step on failure before failing the test.
skippedbooleanNoSkip this step at execution time.

​
Shorthand

Assertion text as a single string. 
- assertVisually: there is a twitter profile shown on the page

​
Examples

- assertVisually:
    that: |
      the module's two substeps (return 1 and return 2) both have green check
      marks to their left, but the top-level "return 3" step that comes after
      the module does NOT have a green check mark
    timeout: 60000

- assertVisually:
    that: |
      none of the step cards on the left-hand side of the editor have
      a green check mark next to them