← Node guide
Device actions

Scroll

Scroll a list or a page. It is a Swipe with the geometry already worked out: a direction, a distance, and a speed.

device.scrollHands-on runs — not reliable unattended
The piece

Scroll a list or page. It's a Swipe with the geometry worked out for you: pick a direction and how far to travel as a % of the screen (0–100), so the same scroll works on any resolution. Duration sets the feel — short = a fling that keeps coasting, long = a controlled drag. Tune and rehearse it on the live device when it runs, or author it here.

Reach for it when

  • Reaching something below the fold.
  • Paging sideways through tabs or a carousel.
Scroll
Idle
In the bag

Every setting this block has. A field marked only when appears once you have chosen the mode above it — those are alternatives to each other, not extra things to fill in.

  • Direction
    starts at Down (further into the list)

    Which way the content moves — “Down” goes further down the list (the finger swipes upward).

    Down (further into the list)Up (back towards the top)Left (next page)Right (previous page)
  • Distance (% of screen)
    starts at 60

    How far the finger travels, as a % of the screen. 60 is about one comfortable scroll; the swipe stays centred, so it never starts on a system gesture edge.

  • Duration
    starts at 300ms

    How long the drag takes. Short = a fling (the list keeps scrolling after the finger lifts); long = a slow, controlled scroll that stops where you left it.

  • Tune the scroll on the device when it runs
    starts at off

    Pause the run at this step and stream the live device: adjust the direction/distance/speed, press Try it to see how far it actually scrolls, then confirm — it scrolls and continues, and the settings are saved back onto this node (2½ min limit — the step is skipped if you don't confirm in time). Disables scheduling.

Build it

  1. Pick a direction and how far

    Distance is a percentage of the screen. 60 is about one comfortable scroll, and the swipe stays centred so it never starts on a system gesture edge.

    ScrollSettings
    Direction
    Down (further into the list)
    Distance (% of screen)
    60
    DurationShort = a fling
    300ms

  2. Read “Down” as where the content goes

    Down moves further down the list — which means the finger swipes upward.

    Shopfinger travels up
    content moves down the list

  3. Or tune it against the real screen

    “Tune the scroll on the device when it runs” pauses the run, streams the device, and gives you a Try it button — adjust until it lands where you want, confirm, and the settings are saved back onto the node.

    ScrollSettings
    Tune the scroll on the device when it runsDisables scheduling
    on
What comes out
  • Nothing new — follow it with a Wait for Element or an Assert on what you scrolled to.
Watch out
  • Scrolling to something and asserting immediately catches the fling still moving. A short Wait for Element between them is the fix.
  • A scroll that reaches the end of a list does not fail. Assert, do not count scrolls.
Usually next to
Wait for ElementAssert / VerifySwipe