playwright_iframe_fill
Fill specific elements within iframes using CSS selectors. Enables browser automation by targeting nested content, ensuring precise interaction with web page components via Playwright MCP Server.
Instructions
Fill an element in an iframe on the page
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| iframeSelector | Yes | CSS selector for the iframe containing the element to fill | |
| selector | Yes | CSS selector for the element to fill | |
| value | Yes | Value to fill |
Implementation Reference
- src/tools/browser/interaction.ts:71-86 (handler)The IframeFillTool class provides the core handler logic for the 'playwright_iframe_fill' tool. It uses Playwright's frameLocator to locate the iframe and fill the specified element with the given value.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}`); }); } }
- src/tools.ts:136-148 (schema)The input schema definition for the 'playwright_iframe_fill' tool, specifying required parameters: iframeSelector, selector, and value.{ 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"], }, },
- src/toolHandler.ts:490-491 (registration)Registration and dispatch in the main handleToolCall switch statement, routing calls to the IframeFillTool instance.case "playwright_iframe_fill": return await iframeFillTool.execute(args, context);
- src/toolHandler.ts:322-323 (registration)Instantiation of the IframeFillTool instance during tool initialization.if (!iframeClickTool) iframeClickTool = new IframeClickTool(server); if (!iframeFillTool) iframeFillTool = new IframeFillTool(server);
- src/tools.ts:455-455 (schema)The tool name is listed in the BROWSER_TOOLS array for conditional browser launching."playwright_iframe_fill",