browser_scroll_by_pixels

Control browser scrolling precisely by specifying exact pixel amounts horizontally and vertically for automated web testing and interaction.

Instructions

Scroll by a specific number of pixels

Input Schema

TableJSON Schema

Name	Required	Description	Default
`x`	Yes	Number of pixels to scroll horizontally
`y`	Yes	Number of pixels to scroll vertically

Implementation Reference

src/tools/actionTools.ts:350-376 (registration)

Registers the 'browser_scroll_by_pixels' MCP tool, including input schema (x, y pixels), description, and handler function that uses ActionService to perform the scroll.

server.tool(
  'browser_scroll_by_pixels',
  'Scroll by a specific number of pixels',
  {
    x: z.number().describe('Number of pixels to scroll horizontally'),
    y: z.number().describe('Number of pixels to scroll vertically'),
  },
  async ({ x, y }) => {
    try {
      const driver = stateManager.getDriver();
      const actionService = new ActionService(driver);
      await actionService.scrollByPixels(x, y);
      return {
        content: [{ type: 'text', text: `Scrolled by pixels (${x}, ${y})` }],
      };
    } catch (e) {
      return {
        content: [
          {
            type: 'text',
            text: `Error scrolling by pixels: ${(e as Error).message}`,
          },
        ],
      };
    }
  }
);

src/tools/actionTools.ts:357-375 (handler)

The MCP tool handler function that executes the scroll by instantiating ActionService and calling scrollByPixels.

async ({ x, y }) => {
  try {
    const driver = stateManager.getDriver();
    const actionService = new ActionService(driver);
    await actionService.scrollByPixels(x, y);
    return {
      content: [{ type: 'text', text: `Scrolled by pixels (${x}, ${y})` }],
    };
  } catch (e) {
    return {
      content: [
        {
          type: 'text',
          text: `Error scrolling by pixels: ${(e as Error).message}`,
        },
      ],
    };
  }
}

src/tools/actionTools.ts:353-356 (schema)

Zod input schema defining parameters x (horizontal pixels) and y (vertical pixels) for the tool.

{
  x: z.number().describe('Number of pixels to scroll horizontally'),
  y: z.number().describe('Number of pixels to scroll vertically'),
},

src/services/actionService.ts:87-89 (helper)
Supporting method in ActionService that executes the JavaScript window.scrollBy(x, y) via Selenium WebDriver to perform the actual scrolling.
```
async scrollByPixels(x: number, y: number): Promise<void> {
  await this.driver.executeScript(`window.scrollBy(${x}, ${y});`);
}
```

Selenium MCP Server