Commands
scroll
Scroll the screen in a specified direction using the mouse wheel.
Command: scroll
Description
The scroll
command is used to scroll the screen in a specified direction using the mouse wheel. This is useful for navigating through content that extends beyond the visible area.
Arguments
Argument | Type | Description |
---|---|---|
direction | string | The direction to scroll. Available directions are: up , down , left , right . |
amount | number | (Optional) Pixels to scroll. If not specified, a default amount is used. |
Example usage
Protips
-
Be sure to focus the application and frame you are trying to scroll before using the command.
-
Use precise
amount
values to control the scrolling distance for better accuracy in your tests. -
Combine the
scroll
command with other commands likehover-text
ormatch-image
to interact with elements that are initially off-screen. -
The most reliable way to scroll to the top or bottom of the page is to use the
home
andend
keys:
Gotchas
- Scrolling too far may cause elements to move out of view. Adjust the
amount
value as needed. - Ensure the application or browser window is in focus when using this command to avoid unexpected behavior.
Notes
- The
scroll
command is ideal for navigating through long pages or lists during automated tests. - This command supports both vertical and horizontal scrolling for flexible navigation.