mcp-playwright

Instructions

Implementation Reference

• src/tools/browser/interaction.ts:21-46 (handler)

  ClickAndSwitchTabTool class with execute method implementing the core logic: clicks selector, waits for new tab, switches to it using setGlobalPage, and returns success message with new URL.
  export class ClickAndSwitchTabTool extends BrowserToolBase { /** * Execute the click and switch tab tool */ async execute(args: any, context: ToolContext): Promise<ToolResponse> { return this.safeExecute(context, async (page) => { // Listen for a new tab to open const [newPage] = await Promise.all([ //context.browser.waitForEvent('page'), // Wait for a new page (tab) to open page.context().waitForEvent('page'),// Wait for a new page (tab) to open page.click(args.selector), // Click the link that opens the new tab ]); // Wait for the new page to load await newPage.waitForLoadState('domcontentloaded'); // Switch control to the new tab setGlobalPage(newPage); //page= newPage; // Update the current page to the new tab //context.page = newPage; //context.page.bringToFront(); // Bring the new tab to the front return createSuccessResponse(`Clicked link and switched to new tab: ${newPage.url()}`); //return createSuccessResponse(`Clicked link and switched to new tab: ${context.page.url()}`); }); }
• src/tools.ts:436-445 (schema)

  Tool schema definition including name, description, and inputSchema requiring 'selector'.
  name: "playwright_click_and_switch_tab", description: "Click a link and switch to the newly opened tab", inputSchema: { type: "object", properties: { selector: { type: "string", description: "CSS selector for the link to click" }, }, required: ["selector"], }, },
• src/toolHandler.ts:550-551 (registration)

  Switch case in handleToolCall that routes the tool call to ClickAndSwitchTabTool.execute
  case "playwright_click_and_switch_tab": return await clickAndSwitchTabTool.execute(args, context);
• src/toolHandler.ts:348-348 (registration)

  Instantiation of ClickAndSwitchTabTool instance in initializeTools
  if (!clickAndSwitchTabTool) clickAndSwitchTabTool = new ClickAndSwitchTabTool(server);
• src/toolHandler.ts:46-46 (registration)

  Import of ClickAndSwitchTabTool class
  import { ClickAndSwitchTabTool } from './tools/browser/interaction.js';