mcp-playwright

Instructions

Implementation Reference

• src/tools/browser/interaction.ts:219-234 (handler)

  PressKeyTool class implementing the tool logic: optionally focuses a selector then presses the specified key using Playwright's keyboard API.

  export class PressKeyTool extends BrowserToolBase {
    /**
     * Execute the key press tool
     */
    async execute(args: any, context: ToolContext): Promise<ToolResponse> {
      return this.safeExecute(context, async (page) => {
        if (args.selector) {
          await page.waitForSelector(args.selector);
          await page.focus(args.selector);
        }
        
        await page.keyboard.press(args.key);
        return createSuccessResponse(`Pressed key: ${args.key}`);
      });
    }
  } 

• src/tools.ts:399-410 (schema)

  Input schema definition for the playwright_press_key tool, specifying parameters 'key' (required) and 'selector' (optional).

  {
    name: "playwright_press_key",
    description: "Press a keyboard key",
    inputSchema: {
      type: "object",
      properties: {
        key: { type: "string", description: "Key to press (e.g. 'Enter', 'ArrowDown', 'a')" },
        selector: { type: "string", description: "Optional CSS selector to focus before pressing key" }
      },
      required: ["key"],
    },
  },

• src/toolHandler.ts:546-547 (registration)

  Switch case registration in handleToolCall function dispatching execution to the PressKeyTool instance.

  case "playwright_press_key":
    return await pressKeyTool.execute(args, context);

• src/toolHandler.ts:346-346 (registration)

  Lazy initialization of the PressKeyTool instance in initializeTools function.

  if (!pressKeyTool) pressKeyTool = new PressKeyTool(server);