Merge pull request #124 from fwilliams96/feature/iframe-fill

feat: playwright_iframe_fill

Author: executeautomation

docs/docs/playwright-web/Supported-Tools.mdx

@@ -171,6 +171,17 @@ Click elements in an iframe on the page.
 
 ---
 
+### Playwright_iframe_fill
+Fill elements in an iframe on the page.
+
+- **`iframeSelector`** *(string)*:  
+  CSS selector for the iframe containing the element to fill.
+
+- **`selector`** *(string)*:  
+  CSS selector for the element to fill.
+
+---
+
 ### Playwright_hover
 Hover over elements on the page.
 

src/__tests__/toolHandler.test.ts

@@ -15,12 +15,14 @@ jest.mock('playwright', () => {
   const mockOn = jest.fn();
   const mockIsClosed = jest.fn().mockReturnValue(false);
 
-  // Mock iframe click
+  // Mock iframe click and fill
   const mockIframeClick = jest.fn().mockImplementation(() => Promise.resolve());
+  const mockIframeFill = jest.fn().mockImplementation(() => Promise.resolve());
   const mockIframeLocator = jest.fn().mockReturnValue({
-    click: mockIframeClick
+    click: mockIframeClick,
+    fill: mockIframeFill
   });
-  
+
   // Mock locator
   const mockLocatorClick = jest.fn().mockImplementation(() => Promise.resolve());
   const mockLocatorFill = jest.fn().mockImplementation(() => Promise.resolve());

src/toolHandler.ts

@@ -25,7 +25,8 @@ import {
   FillTool,
   SelectTool,
   HoverTool,
-  EvaluateTool
+  EvaluateTool,
+  IframeFillTool
 } from './tools/browser/interaction.js';
 import { 
   VisibleTextTool, 
@@ -73,6 +74,7 @@ let closeBrowserTool: CloseBrowserTool;
 let consoleLogsTool: ConsoleLogsTool;
 let clickTool: ClickTool;
 let iframeClickTool: IframeClickTool;
+let iframeFillTool: IframeFillTool;
 let fillTool: FillTool;
 let selectTool: SelectTool;
 let hoverTool: HoverTool;
@@ -310,6 +312,7 @@ function initializeTools(server: any) {
   if (!consoleLogsTool) consoleLogsTool = new ConsoleLogsTool(server);
   if (!clickTool) clickTool = new ClickTool(server);
   if (!iframeClickTool) iframeClickTool = new IframeClickTool(server);
+  if (!iframeFillTool) iframeFillTool = new IframeFillTool(server);
   if (!fillTool) fillTool = new FillTool(server);
   if (!selectTool) selectTool = new SelectTool(server);
   if (!hoverTool) hoverTool = new HoverTool(server);
@@ -474,6 +477,9 @@ export async function handleToolCall(
 
       case "playwright_iframe_click":
         return await iframeClickTool.execute(args, context);
+
+      case "playwright_iframe_fill":
+        return await iframeFillTool.execute(args, context);
 
       case "playwright_fill":
         return await fillTool.execute(args, context);

src/tools.ts

@@ -133,6 +133,19 @@ export function createToolDefinitions() {
         required: ["iframeSelector", "selector"],
       },
     },
+    {
+      name: "playwright_iframe_fill",
+      description: "Fill an element in an iframe on the page",
+      inputSchema: {
+        type: "object",
+        properties: {
+          iframeSelector: { type: "string", description: "CSS selector for the iframe containing the element to fill" },
+          selector: { type: "string", description: "CSS selector for the element to fill" },
+          value: { type: "string", description: "Value to fill" },
+        },
+        required: ["iframeSelector", "selector", "value"],
+      },
+    },
     {
       name: "playwright_fill",
       description: "fill out an input field",
@@ -418,6 +431,7 @@ export const BROWSER_TOOLS = [
   "playwright_screenshot",
   "playwright_click",
   "playwright_iframe_click",
+  "playwright_iframe_fill",
   "playwright_fill",
   "playwright_select",
   "playwright_hover",

src/tools/browser/interaction.ts

@@ -65,6 +65,26 @@ export class IframeClickTool extends BrowserToolBase {
   }
 }
 
+/**
+ * Tool for filling elements inside iframes
+ */
+export class IframeFillTool extends BrowserToolBase {
+  /**
+   * Execute the iframe fill tool
+   */
+  async execute(args: any, context: ToolContext): Promise<ToolResponse> {
+    return this.safeExecute(context, async (page) => {
+      const frame = page.frameLocator(args.iframeSelector);
+      if (!frame) {
+        return createErrorResponse(`Iframe not found: ${args.iframeSelector}`);
+      }
+      
+      await frame.locator(args.selector).fill(args.value);
+      return createSuccessResponse(`Filled element ${args.selector} inside iframe ${args.iframeSelector} with: ${args.value}`);
+    });
+  }
+}
+
 /**
  * Tool for filling form fields
  */

src/tools/index.ts

@@ -8,6 +8,7 @@ export const BROWSER_TOOLS = [
   "playwright_screenshot",
   "playwright_click",
   "playwright_iframe_click",
+  "playwright_iframe_fill",
   "playwright_fill",
   "playwright_select",
   "playwright_hover",