bdg dom scroll

​

Overview

​

Syntax

bdg dom scroll [selector] [options]

​

Arguments

​

Options

​

Behavior

​

Element scrolling

• Scrolls element into view (centered vertically)
• Uses instant scrolling (no smooth animation)
• Returns original scroll position for restoration

​

Post-scroll stability

• Network idle (no requests for 150ms)
• DOM stable (no mutations for 200ms)
• Maximum wait: 2 seconds

​

Examples

​

Scroll to element

# By selector
bdg dom scroll "footer"
bdg dom scroll "#section-2"
bdg dom scroll ".product-card"

# By cached index
bdg dom query ".nav-link"
bdg dom scroll 2

​

Scroll by pixels

# Scroll down
bdg dom scroll --down 500

# Scroll up
bdg dom scroll --up 300

# Scroll horizontally
bdg dom scroll --right 200
bdg dom scroll --left 100

​

Scroll to boundaries

# Top of page
bdg dom scroll --top

# Bottom of page
bdg dom scroll --bottom

​

Skip waiting

# For pages without lazy loading
bdg dom scroll "footer" --no-wait

​

Common workflows

​

Load more content

# Scroll to bottom to trigger infinite scroll
bdg dom scroll --bottom
# Waits for new content to load

# Verify new content loaded
bdg dom query ".product-card"

​

Navigate to section

# Query sections
bdg dom query "section"
# [0] <section#intro>
# [1] <section#features>
# [2] <section#pricing>

# Scroll to pricing section
bdg dom scroll 2

​

Screenshot visible area

# Scroll element into view before screenshot
bdg dom screenshot footer.png --scroll "footer"

# Or manually
bdg dom scroll "#chart"
bdg dom screenshot chart.png --no-full-page

​

Scroll modes

​

Element-based (with selector)

bdg dom scroll "#element"

• Centers element vertically in viewport
• Waits for lazy-loaded content by default
• Returns original scroll position

​

Relative (with pixel offsets)

bdg dom scroll --down 500 --right 100

• Scrolls relative to current position
• Can combine vertical and horizontal
• No element targeting

​

Absolute (with boundaries)

bdg dom scroll --bottom

• Scrolls to fixed position
• --top goes to (0, 0)
• --bottom goes to maximum scroll height

​

Exit codes

​

Lazy loading detection

1. Network activity: Monitors resource requests via Performance Observer
2. DOM mutations: Tracks element additions and changes via MutationObserver
3. Stability thresholds: Waits until both network and DOM are idle

​

Troubleshooting

​

Content not loading

1. Verify the page uses scroll-triggered loading
2. Check scroll reached the trigger point: bdg dom eval 'window.scrollY'
3. Increase wait time manually: bdg dom scroll --bottom && sleep 2

​

Scroll position wrong

1. Check element is visible: bdg dom get <selector>
2. Verify element has dimensions: bdg dom get <selector> --raw
3. Try scrolling by pixels instead: bdg dom scroll --down 500

​

Related commands

• bdg dom screenshot - Capture screenshots with --scroll option
• bdg dom query - Find elements to scroll to
• bdg dom eval - Check scroll position programmatically