scrollTo

Scrolls a container until the target is visible. The simplified form takes the target as a single string.

Parameters

Parameter	Type	Required	Description
`on`	`string`	Yes	Target description or percent pair to scroll to.
`direction`	`up \| down`	No	Direction to scroll while searching. Defaults to down.
`in`	`string \| { x, y, delta }`	No	Scroll container: `screen`, `app`, `webview`, a description, or raw coordinates.
`scrollStepPercent`	`number \| string`	No	Distance per scroll as a percent of the viewport (e.g. `50`).
`maxScrollAttempts`	`number`	No	Maximum number of scroll gestures before giving up.
`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

Target as a single string.

- scrollTo: the "Delete account" row

Examples

- scrollTo:
    on: the "Delete account" row
    in: the settings list # scroll this container, not the whole screen
    direction: down
    maxScrollAttempts: 10 # give up after 10 swipes

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