Method scroll

src/environment/browser/service.py:476–533

Scroll the page by specified number of pages (set down=True to scroll down, down=False to scroll up, num_pages=number of pages to scroll like 0.5 for half page, 10.0 for ten pages, etc.). Default behavior is to scroll the entire page. This is enough for most cases. Optional if there

(self, request: ScrollRequest)

            )

    async def scroll(self, request: ScrollRequest) -> ActionResult:
        """Scroll the page by specified number of pages (set down=True to scroll down, down=False to scroll up, num_pages=number of pages to scroll like 0.5 for half page, 10.0 for ten pages, etc.). 
        Default behavior is to scroll the entire page. This is enough for most cases.
        Optional if there are multiple scroll containers, use frame_element_index parameter with an element inside the container you want to scroll in. For that you must use indices that exist in your browser_state (works well for dropdowns and custom UI components). 
        Instead of scrolling step after step, use a high number of pages at once like 10 to get to the bottom of the page.
        If you know where you want to scroll to, use scroll_to_text instead of this tool.
        """
        try:
            # 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 request.frame_element_index is not None and request.frame_element_index != 0:
                node = await self._session.get_element_by_index(request.frame_element_index)
                if node is None:
                    # Element does not exist
                    return ActionResult(
                        success=False,
                        message=f'Element index {request.frame_element_index} not found in browser state',
                        extra={"error": f"Element index {request.frame_element_index} not found"}
                    )

            # Dispatch scroll event with node - the complex logic is handled in the event handler
            # Convert pages to pixels (assuming 1000px per page as standard viewport height)
            pixels = int(request.num_pages * 1000)
            event = self._session.event_bus.dispatch(
                ScrollEvent(direction='down' if request.down else 'up', amount=pixels, node=node)
            )
            await event
            await event.event_result(raise_if_any=True, raise_if_none=False)
            direction = 'down' if request.down else 'up'

            # If index is 0 or None, we're scrolling the page
            target = (
                'the page'
                if request.frame_element_index is None or request.frame_element_index == 0
                else f'element {request.frame_element_index}'
            )

            if request.num_pages == 1.0:
                long_term_memory = f'Scrolled {direction} {target} by one page'
            else:
                long_term_memory = f'Scrolled {direction} {target} by {request.num_pages} pages'

            msg = f'🔍 {long_term_memory}'
            logger.info(msg)
            return ActionResult(
                success=True,
                message=f"Successfully scrolled {direction} {target}",
                extra={"memory": long_term_memory}
            )
        except Exception as e:
            logger.error(f'Failed to dispatch ScrollEvent: {type(e).__name__}: {e}')
            error_msg = 'Failed to execute scroll action.'
            return ActionResult(
                success=False,
                message=error_msg,
                extra={"error": str(e)}
            )