Scroll
Scroll a list or surface in a direction, optionally polling a "Scroll Until" condition that stops the scroll. Five directions, six speeds, region narrowing, and List Bounds Memory caching.
Scroll moves a scrollable surface in a direction. With Scroll Until set, it stops when a visual condition is met instead of scrolling a fixed amount — that's the most useful mode and what you'll reach for first.
Settings
The Scroll editor exposes:
| Field | What it does |
|---|---|
| List description* | Plain-language description of the list/surface to scroll. Supports $placeholders. |
| Scroll Until | Optional question that stops the scroll the moment the answer is yes — e.g. 'Do you see the row labeled $product?'. Supports $placeholders. Empty means scroll a fixed amount. |
| Scroll Direction | auto, up, down, left, or right. Default down. |
| Scroll Speed | auto, ultraSlow, slow, normal, fast, or ultraFast. Default normal. |
| Region of Interest | Default 'all'. Narrows the scroll target and the until-condition search to a band of the screen (top nav, content, bottom nav, etc.). See Region of Interest. |
| AI Segmentation | How the AI looks at the screen. Choose None, Auto, or Force Fresh. |
| List Bounds Memory | On by default. Reuses a remembered scrollable region when the screen looks the same instead of re-identifying from scratch. A 'Clear' button appears once memory has been stored for this step. |
When the test's self-healing mode is Per Step, a per-step Self-healing toggle also appears.
What's possible
-
Scroll until something appears:
Scroll Until = Do you see the row labeled '$product'? -
Scroll the right area in the right direction:
List description = the segmented control of stories at the top,Scroll Direction = right. -
Scroll horizontally-scrolling rails (carousels) by setting Scroll Direction to left or right.
-
Combine with a region: setting the Region to the content area ensures Mavster scrolls the page body, not a header or tab bar.
What's not possible
-
Scroll to an offscreen element you can't describe — Mavster needs something identifiable in the Scroll Until text to know when to stop.
-
Scroll forever — Mavster gives up after a sane number of attempts and fails the step. If you need long polling, use Wait Until.
-
Scroll while typing — chain a separate Tap or Built-In: Tap to Dismiss to dismiss the keyboard first.
Common patterns
-
Scroll Until is your friend. Always prefer "scroll until X appears" over "scroll N times". The former is robust to lists changing length; the latter isn't.
-
Set a region on dense screens. When the page has multiple scrollable regions (tab bar, body, bottom sheet), narrow the region to whichever one you mean.
-
Keep List Bounds Memory on. Repeated runs of the same Scroll step reuse the remembered list bounds, which is significantly faster than re-detecting from scratch.