Skip to content

Scroll Page Node

Automation/Browser/Interact

Scrolls the page, or a scrollable container, by a distance or to its top or bottom, and reports where it ended up. Use At Bottom to stop infinite-scroll loops.

browser_scroll_pageautomationLocal only
Inputs7
Outputs5
Security exposure8/10
Packageautomation

Ratings

Scores range from 0 to 10. Higher values mean more impact, exposure, or operational weight.

SecurityAttack surface and exposure impact.
8/10High
PrivacyPotential sensitivity of processed data.
8/10High
PerformanceRuntime or resource pressure.
9/10High
GovernancePolicy, audit, or compliance impact.
7/10High
ReliabilityOperational stability considerations.
8/10High
CostExternal or compute cost impact.
10/10High

Input Pins

7

▶

Execution
exec_in

Trigger

Session

Struct
session

Automation session

AutomationSessionAutomationSession11 fields
session_refstringrequired
platformPlatformrequired
enum "Windows", "MacOS", "Linux"
default_delay_msinteger:uint64required
format uint64min 0
click_delay_msinteger:uint64required
format uint64min 0
debug_modebooleanrequired
browser_typeanyOf (2)

Browser context info if browser is attached

variant 1BrowserTypevariant
enum "Chrome", "Firefox", "Edge", "Safari"
variant 2nullvariant
browser_headlessboolean | null
browser_user_data_dirstring | null
current_page_refstring | null

Current page info if a page is open

current_window_handlestring | null
browser_frame_selectorsArray<Selector>
default []
itemsSelectorarray item
kindSelectorKindrequired
variant 1enumvariant
enum "Css", "Xpath", "TextExact", "TestId"...
variant 2constvariant

Visible text contained in the element; script, style and head content is ignored.

const "Text"
variant 3constvariant

ARIA role, optionally filtered by accessible name: `button`, `button|Sign in` (case-insensitive substring), `button|=Sign in` (exact) or `button|/^sign/i` (regex).

const "Role"
variant 4constvariant

Element ref from the latest Browser Snapshot, such as `e12`.

const "Ref"
valuestringrequired
confidencenumber | null
format double
scopestring | null

Mode

String
mode

by scrolls by Delta X/Y; top and bottom jump to the vertical ends

Default by
bytopbottom

Delta X

Float
delta_x

Horizontal distance in CSS pixels for mode 'by'; negative scrolls left

Default 0

Delta Y

Float
delta_y

Vertical distance in CSS pixels for mode 'by'; negative scrolls up

Default 600

Container

String
scope

CSS selector of a scrollable container; empty scrolls the page

Locator

Struct
locator

Typed selector, including its kind and optional CSS scope. Overrides the legacy CSS selector when connected.

SelectorSelector4 fields
kindSelectorKindrequired
variant 1enumvariant
enum "Css", "Xpath", "TextExact", "TestId"...
variant 2constvariant

Visible text contained in the element; script, style and head content is ignored.

const "Text"
variant 3constvariant

ARIA role, optionally filtered by accessible name: `button`, `button|Sign in` (case-insensitive substring), `button|=Sign in` (exact) or `button|/^sign/i` (regex).

const "Role"
variant 4constvariant

Element ref from the latest Browser Snapshot, such as `e12`.

const "Ref"
valuestringrequired
confidencenumber | null
format double
scopestring | null

Output Pins

5

▶

Execution
exec_out

Continue

Session

Struct
session_out

Updated automation session

AutomationSessionAutomationSession11 fields
session_refstringrequired
platformPlatformrequired
enum "Windows", "MacOS", "Linux"
default_delay_msinteger:uint64required
format uint64min 0
click_delay_msinteger:uint64required
format uint64min 0
debug_modebooleanrequired
browser_typeanyOf (2)

Browser context info if browser is attached

variant 1BrowserTypevariant
enum "Chrome", "Firefox", "Edge", "Safari"
variant 2nullvariant
browser_headlessboolean | null
browser_user_data_dirstring | null
current_page_refstring | null

Current page info if a page is open

current_window_handlestring | null
browser_frame_selectorsArray<Selector>
default []
itemsSelectorarray item
kindSelectorKindrequired
variant 1enumvariant
enum "Css", "Xpath", "TextExact", "TestId"...
variant 2constvariant

Visible text contained in the element; script, style and head content is ignored.

const "Text"
variant 3constvariant

ARIA role, optionally filtered by accessible name: `button`, `button|Sign in` (case-insensitive substring), `button|=Sign in` (exact) or `button|/^sign/i` (regex).

const "Role"
variant 4constvariant

Element ref from the latest Browser Snapshot, such as `e12`.

const "Ref"
valuestringrequired
confidencenumber | null
format double
scopestring | null

Scroll X

Integer
scroll_x

Horizontal scroll offset after scrolling, in CSS pixels

Scroll Y

Integer
scroll_y

Vertical scroll offset after scrolling, in CSS pixels

At Bottom

Boolean
at_bottom

True when the page or container cannot scroll further down

Node Info

Internal name
browser_scroll_page
Category
Automation/Browser/Interact
Version
1