playwright_get_visible_text

Instructions

Implementation Reference

• src/tools/browser/visiblePage.ts:8-58 (handler)

  Implements the core handler logic for 'playwright_get_visible_text' by using Playwright's page.evaluate to run JavaScript that traverses the DOM TreeWalker for visible text nodes (excluding hidden elements), collects and trims text content.

  export class VisibleTextTool extends BrowserToolBase {
    /**
     * Execute the visible text page tool
     */
    async execute(args: any, context: ToolContext): Promise<ToolResponse> {
      // Check if browser is available
      if (!context.browser || !context.browser.isConnected()) {
        // If browser is not connected, we need to reset the state to force recreation
        resetBrowserState();
        return createErrorResponse(
          "Browser is not connected. The connection has been reset - please retry your navigation."
        );
      }
  
      // Check if page is available and not closed
      if (!context.page || context.page.isClosed()) {
        return createErrorResponse(
          "Page is not available or has been closed. Please retry your navigation."
        );
      }
      return this.safeExecute(context, async (page) => {
        try {
          const visibleText = await page!.evaluate(() => {
            const walker = document.createTreeWalker(
              document.body,
              NodeFilter.SHOW_TEXT,
              {
                acceptNode: (node) => {
                  const style = window.getComputedStyle(node.parentElement!);
                  return (style.display !== "none" && style.visibility !== "hidden")
                    ? NodeFilter.FILTER_ACCEPT
                    : NodeFilter.FILTER_REJECT;
                },
              }
            );
            let text = "";
            let node;
            while ((node = walker.nextNode())) {
              const trimmedText = node.textContent?.trim();
              if (trimmedText) {
                text += trimmedText + "\n";
              }
            }
            return text.trim();
          });
          return createSuccessResponse(`Visible text content:\n${visibleText}`);
        } catch (error) {
          return createErrorResponse(`Failed to get visible text content: ${(error as Error).message}`);
        }
      });
    }

• src/tools.ts:318-325 (schema)

  Defines the tool's metadata, description, and input schema (no required parameters). Part of createToolDefinitions() used for MCP tool registration.

    name: "playwright_get_visible_text",
    description: "Get the visible text content of the current page",
    inputSchema: {
      type: "object",
      properties: {},
      required: [],
    },
  },

• src/toolHandler.ts:495-496 (registration)

  Dispatches tool calls matching 'playwright_get_visible_text' to the VisibleTextTool instance's execute method in the main handleToolCall switch statement.

  case "playwright_get_visible_text":
    return await visibleTextTool.execute(args, context);

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

  Instantiates the VisibleTextTool class instance (visibleTextTool) during tool initialization in initializeTools().

  if (!visibleTextTool) visibleTextTool = new VisibleTextTool(server);

• src/toolHandler.ts:31-33 (registration)

  Imports the VisibleTextTool class from its implementation file.

    VisibleTextTool,
    VisibleHtmlTool,
  } from "./tools/browser/visiblePage.js";