Skip to content

Scroll until

  • Type browser.scrollUntil
  • Group Browser
  • Role action
  • Risk reads only
  • Side effect safe to repeat
  • Runs once per item
  • Needs browser

Scrolls like a person until an element shows, the end, N times or a time

Also available to AI agents and over MCP as a tool.

until

Until · string · required · default end · one of element, end, count, time

When to stop: an element appears, a count of items is loaded, the page stops growing, or a time is up.

selector

Selector · string · optional

The element (or the repeated items) the stop condition watches.

Shown when until is element.

count

Count · integer · optional · default 10 · range 1 – 1000

Shown when until is count.

seconds

Seconds · integer · optional · default 30 · range 1 – 3600

Shown when until is time.

idleRounds

Tries at the end · integer · optional · default 3 · range 1 – 20

Shown when until is end.

stepMin

Smallest step (px) · integer · optional · default 300 · range 50 – 5000

stepMax

Largest step (px) · integer · optional · default 900 · range 50 – 5000

pauseMinMs

Shortest pause (ms) · integer · optional · default 400 · range 0 – 60000

Shortest pause between scrolls; with the longest one it makes scrolling look human.

pauseMaxMs

Longest pause (ms) · integer · optional · default 1500 · range 0 – 60000

seed

Randomness · object · optional · default {"mode":"random"}

Fields:

  • mode (string) Mode
  • value (integer) Value

timeoutMs

Timeout (ms) · integer · optional · default 120000 · range 0 – 3600000

How long to wait, in milliseconds, before the step fails.

  • main

← All nodes