Skip to content

Open-source Python library for AI browser agents, plus Browser Use Cloud: stealth browsers and a hosted agent API.

rename ScrollAction.index to frame_element_index because llm was misusing it often

Nick Sweeting22ae5afd73f7
diff --git a/browser_use/controller/service.py b/browser_use/controller/service.py
index d6c839ca8..2e3af0c93 100644
--- a/browser_use/controller/service.py
+++ b/browser_use/controller/service.py
@@ -580,15 +580,15 @@ Provide the extracted information in a clear, structured format."""
# Look up the node from the selector map if index is provided
# Special case: index 0 means scroll the whole page (root/body element)
node = None
- if params.index is not None and params.index != 0:
+ if params.frame_element_index is not None and params.frame_element_index != 0:
try:
- node = await browser_session.get_element_by_index(params.index)
+ node = await browser_session.get_element_by_index(params.frame_element_index)
if node is None:
# Element not found - return error
- raise ValueError(f'Element index {params.index} not found in DOM')
+ raise ValueError(f'Element index {params.frame_element_index} not found in DOM')
except Exception as e:
# Error getting element - return error
- raise ValueError(f'Failed to get element {params.index}: {e}') from e
+ raise ValueError(f'Failed to get element {params.frame_element_index}: {e}') from e
# Dispatch scroll event with node - the complex logic is handled in the event handler
# Convert pages to pixels (assuming 800px per page as standard viewport height)
@@ -601,7 +601,7 @@ Provide the extracted information in a clear, structured format."""
direction = 'down' if params.down else 'up'
# If index is 0 or None, we're scrolling the page
- target = 'the page' if params.index is None or params.index == 0 else f'element {params.index}'
+ target = 'the page' if params.frame_element_index is None or params.frame_element_index == 0 else f'element {params.frame_element_index}'
if params.num_pages == 1.0:
long_term_memory = f'Scrolled {direction} {target} by one page'
diff --git a/browser_use/controller/views.py b/browser_use/controller/views.py
index c87c4eecb..dfb201b0d 100644
--- a/browser_use/controller/views.py
+++ b/browser_use/controller/views.py
@@ -51,7 +51,7 @@ class CloseTabAction(BaseModel):
class ScrollAction(BaseModel):
down: bool # True to scroll down, False to scroll up
num_pages: float # Number of pages to scroll (0.5 = half page, 1.0 = one page, etc.)
- index: int | None = None # Optional element index to find scroll container for
+ frame_element_index: int | None = None # Optional element index to find scroll container for
class SendKeysAction(BaseModel):