可以通过 Amp VS Code 扩展的设置界面添加，或直接更新 settings.json 文件：

"amp.mcpServers": {
  "playwright": {
    "command": "npx",
    "args": [
      "@playwright/mcp@latest"
    ]
  }
}

Amp CLI 设置：

使用下面的 amp mcp add 命令添加：

amp mcp add playwright -- npx @playwright/mcp@latest

可以通过 Antigravity 的设置界面添加，或直接编辑配置文件：

{
  "mcpServers": {
    "playwright": {
      "command": "npx",
      "args": [
        "@playwright/mcp@latest"
      ]
    }
  }
}

使用 Claude Code CLI 添加 Playwright MCP 服务器：

claude mcp add playwright npx @playwright/mcp@latest

按照 MCP 安装 指南，使用上述标准配置。

请参考 配置 MCP 服务器 部分的说明。

示例：本地设置

将以下内容添加到你的 cline_mcp_settings.json 文件中：

{
  "mcpServers": {
    "playwright": {
      "type": "stdio",
      "command": "npx",
      "timeout": 30,
      "args": [
        "-y",
        "@playwright/mcp@latest"
      ],
      "disabled": false
    }
  }
}

使用 Codex CLI 添加 Playwright MCP 服务器：

codex mcp add playwright npx "@playwright/mcp@latest"

你也可以创建或编辑配置文件 ~/.codex/config.toml，并添加：

[mcp_servers.playwright]
command = "npx"
args = ["@playwright/mcp@latest"]

更多信息，请参阅 Codex MCP 文档。

使用 Copilot CLI 交互式地添加 Playwright MCP 服务器：

/mcp add

或者，创建或编辑配置文件 ~/.copilot/mcp-config.json，并添加：

{
  "mcpServers": {
    "playwright": {
      "type": "local",
      "command": "npx",
      "tools": [
        "*"
      ],
      "args": [
        "@playwright/mcp@latest"
      ]
    }
  }
}

更多信息，请参阅 Copilot CLI 文档。

点击按钮即可安装：

或者手动安装：

前往 Cursor 设置 -> MCP -> 添加新的 MCP 服务器。根据喜好命名，选择 command 类型，并输入命令 npx @playwright/mcp@latest。你还可以通过点击 编辑 来验证配置或添加类似命令的参数。

使用 Factory CLI 添加 Playwright MCP 服务器：

droid mcp add playwright "npx @playwright/mcp@latest"

你也可以在 Factory droid 中输入 /mcp，打开用于管理 MCP 服务器的交互式界面。

更多信息，请参阅 Factory MCP 文档。

按照 MCP 安装 指南，使用上述标准配置。

点击按钮即可安装：

或者手动安装：

前往 高级设置 -> 扩展程序 -> 添加自定义扩展程序。根据您的喜好命名，选择类型为 STDIO，并将 命令 设置为 npx @playwright/mcp。点击“添加扩展程序”。

请遵循 MCP 服务器的 文档。例如，在 .kiro/settings/mcp.json 中：

{
  "mcpServers": {
    "playwright": {
      "command": "npx",
      "args": [
        "@playwright/mcp@latest"
      ]
    }
  }
}

点击按钮即可安装：

或者手动安装：

前往右侧边栏的 程序 -> 安装 -> 编辑 mcp.json。使用上述标准配置。

请遵循 MCP 服务器的 文档。例如，在 ~/.config/opencode/opencode.json 中：

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "playwright": {
      "type": "local",
      "command": [
        "npx",
        "@playwright/mcp@latest"
      ],
      "enabled": true
    }
  }
}

在 VSCode 或 IntelliJ 中打开 Qodo Gen 聊天面板 → 连接更多工具 → + 添加新的 MCP → 粘贴上述标准配置。

点击 保存。

点击按钮即可安装：

或者手动安装：

请按照 MCP 安装 指南，使用上述标准配置。您也可以通过 VS Code CLI 安装 Playwright 的 MCP 服务器：

# 对于 VS Code
code --add-mcp '{"name":"playwright","command":"npx","args":["@playwright/mcp@latest"]}'

安装完成后，Playwright 的 MCP 服务器就可以在 VS Code 中与您的 GitHub Copilot 助手一起使用了。

前往 设置 -> AI -> 管理 MCP 服务器 -> + 添加 来 添加 MCP 服务器。使用上述标准配置。

或者，您也可以在 Warp 提示词中使用斜杠命令 /add-mcp，并粘贴上面的标准配置：

{
  "mcpServers": {
    "playwright": {
      "command": "npx",
      "args": [
        "@playwright/mcp@latest"
      ]
    }
  }
}

请遵循 Windsurf MCP 的 文档。使用上述标准配置。

{
  /**
   * 要使用的浏览器。
   */
  browser?: {
    /**
     * 要使用的浏览器类型。
     */
    browserName?: 'chromium' | 'firefox' | 'webkit';

    /**
     * 将浏览器配置文件保留在内存中，不将其保存到磁盘。
     */
    isolated?: boolean;

    /**
     * 浏览器配置文件持久化的用户数据目录路径。
     * 默认会创建一个临时目录。
     */
    userDataDir?: string;

    /**
     * 传递给以下方法的启动选项：
     * @see https://playwright.dev/docs/api/class-browsertype#browser-type-launch-persistent-context
     *
     * 这对于设置 `channel`、`headless`、`executablePath` 等选项非常有用。
     */
    launchOptions?: playwright.LaunchOptions;

    /**
     * 浏览器上下文的上下文选项。
     *
     * 这对于设置 `viewport` 等选项很有用。
     */
    contextOptions?: playwright.BrowserContextOptions;

    /**
     * 对于 Chromium 系列浏览器，用于连接现有浏览器实例的 Chrome DevTools 协议端点。
     */
    cdpEndpoint?: string;

    /**
     * 与连接请求一起发送的 CDP 头部。
     */
    cdpHeaders?: Record<string, string>;

    /**
     * 连接到 CDP 端点的超时时间，单位为毫秒。默认值为 30000 毫秒（30 秒）。传入 0 表示禁用超时。
     */
    cdpTimeout?: number;

    /**
     * 用于连接现有 Playwright 服务器的远程端点。
     */
    remoteEndpoint?: string;

    /**
     * 要作为 Playwright 页面初始化脚本添加的 TypeScript 文件路径。
     */
    initPage?: string[];

    /**
     * 要作为初始化脚本添加的 JavaScript 文件路径。
     * 这些脚本将在页面的所有脚本之前在每个页面上执行。
     */
    initScript?: string[];
  },

  /**
   * 连接到正在运行的浏览器实例（仅限 Edge/Chrome）。如果指定了此选项，则会忽略 `browser` 配置。
   * 需要安装“Playwright MCP Bridge”浏览器扩展程序。
   */
  extension?: boolean;

  server?: {
    /**
     * 用于 SSE 或 MCP 传输的监听端口。
     */
    port?: number;

    /**
     * 服务器绑定的主机。默认值为 localhost。使用 0.0.0.0 可以绑定到所有接口。
     */
    host?: string;

    /**
     * 此服务器允许服务的主机列表。默认值为服务器绑定的主机。
     * 这不是用于 CORS，而是用于 DNS 重绑定保护。
     */
    allowedHosts?: string[];
  },

  /**
   * 已启用工具功能列表。可能的值包括：
   *   - 'core': 核心浏览器自动化功能。
   *   - 'pdf': PDF 生成和操作。
   *   - 'vision': 基于坐标的交互。
   *   - 'devtools': 开发者工具功能。
   */
  capabilities?: ToolCapability[];

  /**
   * 是否将 Playwright 会话保存到输出目录。
   */
  saveSession?: boolean;

  /**
   * 在所有连接的 HTTP 客户端之间共享同一个浏览器上下文。
   */
  sharedBrowserContext?: boolean;

  /**
   * 密钥用于替换工具响应中的匹配明文，以防止 LLM 不小心获取敏感数据。这是一种便利措施，并非安全功能，请务必始终检查来自客户端的输入和工具输出的信息。
   */
  secrets?: Record<string, string>;

  /**
   * 用于保存输出文件的目录。
   */
  outputDir?: string;

  console?: {
    /**
     * 要返回的控制台消息级别。每个级别包含更严重级别的消息。默认值为 "info"。
     */
    level?: 'error' | 'warning' | 'info' | 'debug';
  },

  network?: {
    /**
     * 允许浏览器请求的源列表。默认情况下允许所有源。同时匹配 `allowedOrigins` 和 `blockedOrigins` 的源将被阻止。
     *
     * 支持的格式：
     * - 完整源：`https://example.com:8080` - 仅匹配该源
     * - 通配符端口：`http://localhost:*` - 匹配本地主机上任何端口的 http 协议
     */
    allowedOrigins?: string[];

    /**
     * 阻止浏览器请求的源列表。同时匹配 `allowedOrigins` 和 `blockedOrigins` 的源将被阻止。
     *
     * 支持的格式：
     * - 完整源：`https://example.com:8080` - 仅匹配该源
     * - 通配符端口：`http://localhost:*` - 匹配本地主机上任何端口的 http 协议
     */
    blockedOrigins?: string[];
  };

  /**
   * 指定用于测试 ID 的属性，默认为 "data-testid"。
   */
  testIdAttribute?: string;

  timeouts?: {
    /*
     * 配置默认操作超时：https://playwright.dev/docs/api/class-page#page-set-default-timeout。默认值为 5000 毫秒。
     */
    action?: number;

    /*
     * 配置默认导航超时：https://playwright.dev/docs/api/class-page#page-set-default-navigation-timeout。默认值为 60000 毫秒。
     */
    navigation?: number;

    /**
     * 配置默认 expect 超时：https://playwright.dev/docs/test-timeouts#expect-timeout。默认值为 5000 毫秒。
     */
    expect?: number;
  };

  /**
   * 是否向客户端发送图片响应。可选值为 "allow"、"omit" 或 "auto"。默认值为 "auto"，即如果客户端能够显示图片则发送。
   */
  imageResponses?: 'allow' | 'omit';

  snapshot?: {
    /**
     * 在为响应拍摄快照时，指定要使用的模式。
     */
    mode?: 'full' | 'none';
  };

  /**
   * allowUnrestrictedFileAccess 作为一道护栏，防止 LLM 不小心超出其预期的工作空间。它是一种方便的防御机制，用于捕捉意外的文件访问行为，但并非安全边界；如果有意尝试访问其他目录，很容易绕过此限制，因此真正的安全性仍需依赖客户端级别的权限控制。
   */
  allowUnrestrictedFileAccess?: boolean;

  /**
   * 指定用于代码生成的语言。
   */
  codegen?: 'typescript' | 'none';
}

注意： 目前 Docker 实现仅支持无头 Chromium。

{
  "mcpServers": {
    "playwright": {
      "command": "docker",
      "args": ["run", "-i", "--rm", "--init", "--pull=always", "mcr.microsoft.com/playwright/mcp"]
    }
  }
}

或者，如果您希望将容器作为长期运行的服务来启动，而不是让 MCP 客户端生成它，则可以使用以下命令：

docker run -d -i --rm --init --pull=always \
  --entrypoint node \
  --name playwright \
  -p 8931:8931 \
  mcr.microsoft.com/playwright/mcp \
  cli.js --headless --browser chromium --no-sandbox --port 8931 --host 0.0.0.0

该服务器将在主机端口 8931 上监听，并可被任何 MCP 客户端访问。

您也可以自行构建 Docker 镜像：

docker build -t mcr.microsoft.com/playwright/mcp .

import http from 'http';

import { createConnection } from '@playwright/mcp';
import { SSEServerTransport } from '@modelcontextprotocol/sdk/server/sse.js';

http.createServer(async (req, res) => {
  // ...

  // 创建一个带有 SSE 传输的无头 Playwright MCP 服务器
  const connection = await createConnection({ browser: { launchOptions: { headless: true } } });
  const transport = new SSEServerTransport('/messages', res);
  await connection.connect(transport);

  // ...
});

• browser_click
  • 标题：点击
  • 描述：在网页上执行点击操作
  • 参数：
    • element（字符串，可选）：用于获取与元素交互权限的人类可读元素描述
    • ref（字符串）：页面快照中目标元素的确切引用
    • selector（字符串，可选）：当无法使用“ref”时，用于定位目标元素的 CSS 或角色选择器
    • doubleClick（布尔值，可选）：是否执行双击而非单击
    • button（字符串，可选）：要点击的按钮，默认为左键
    • modifiers（数组，可选）：要按下的修饰键
  • 只读：否

• browser_close
  • 标题：关闭浏览器
  • 描述：关闭页面
  • 参数：无
  • 只读：否

• browser_console_messages
  • 标题：获取控制台消息
  • 描述：返回所有控制台消息
  • 参数：
    • level（字符串）：要返回的控制台消息级别。每个级别包含更严重级别的消息，默认为“info”。
    • all（布尔值，可选）：是否返回自会话开始以来的所有控制台消息，而不仅仅是自上次导航以来的消息，默认为假。
    • filename（字符串，可选）：用于保存控制台消息的文件名。如果未提供，则以文本形式返回消息。
  • 只读：是

• browser_drag
  • 标题：拖动鼠标
  • 描述：在两个元素之间执行拖放操作
  • 参数：
    • startElement（字符串）：用于获取与源元素交互权限的人类可读描述
    • startRef（字符串）：页面快照中源元素的确切引用
    • startSelector（字符串，可选）：当无法使用“ref”时，用于定位源元素的 CSS 或角色选择器
    • endElement（字符串）：用于获取与目标元素交互权限的人类可读描述
    • endRef（字符串）：页面快照中目标元素的确切引用
    • endSelector（字符串，可选）：当无法使用“ref”时，用于定位目标元素的 CSS 或角色选择器
  • 只读：否

• browser_evaluate
  • 标题：评估 JavaScript
  • 描述：在页面或元素上评估 JavaScript 表达式
  • 参数：
    • function（字符串）：() => { /* 代码 / } 或 (element) => { / 代码 */ }（当提供元素时）
    • element（字符串，可选）：用于获取与元素交互权限的人类可读描述
    • ref（字符串，可选）：页面快照中目标元素的确切引用
    • selector（字符串，可选）：当无法使用“ref”时，用于定位目标元素的 CSS 或角色选择器
    • filename（字符串，可选）：用于保存结果的文件名。如果未提供，结果将以文本形式返回。
  • 只读：否

• browser_file_upload
  • 标题：上传文件
  • 描述：上传一个或多个文件
  • 参数：
    • paths（数组，可选）：要上传文件的绝对路径。可以是单个文件或多个文件。如果省略，则取消文件选择对话框。
  • 只读：否

• browser_fill_form
  • 标题：填写表单
  • 描述：填写多个表单字段
  • 参数：
    • fields（数组）：要填充的字段
  • 只读：否

• browser_handle_dialog
  • 标题：处理对话框
  • 描述：处理对话框
  • 参数：
    • accept（布尔值）：是否接受对话框
    • promptText（字符串，可选）：如果是提示对话框，则输入提示文本
  • 只读：否

• browser_hover
  • 标题：悬停鼠标
  • 描述：在页面上的元素上悬停
  • 参数：
    • element（字符串，可选）：用于获取与元素交互权限的人类可读描述
    • ref（字符串）：页面快照中目标元素的确切引用
    • selector（字符串，可选）：当无法使用“ref”时，用于定位目标元素的 CSS 或角色选择器
  • 只读：否

• browser_navigate
  • 标题：导航到 URL
  • 描述：导航到指定的 URL
  • 参数：
    • url（字符串）：要导航到的 URL
  • 只读：否

• browser_navigate_back
  • 标题：返回
  • 描述：返回到历史记录中的上一页
  • 参数：无
  • 只读：否

• browser_network_requests
  • 标题：列出网络请求
  • 描述：返回自页面加载以来的所有网络请求
  • 参数：
    • static（布尔值）：是否包含成功的静态资源，如图片、字体、脚本等。默认为 false。
    • requestBody（布尔值）：是否包含请求体。默认为 false。
    • requestHeaders（布尔值）：是否包含请求头。默认为 false。
    • filter（字符串，可选）：仅返回 URL 匹配此正则表达式的请求（例如：“/api/.*user”）。
    • filename（字符串，可选）：用于保存网络请求的文件名。如果不提供，则以文本形式返回请求。
  • 只读：true

• browser_press_key
  • 标题：按下按键
  • 描述：在键盘上按下某个键
  • 参数：
    • key（字符串）：要按下的键名或要生成的字符，例如 ArrowLeft 或 a
  • 只读：false

• browser_resize
  • 标题：调整浏览器窗口大小
  • 描述：调整浏览器窗口的宽度和高度
  • 参数：
    • width（数字）：浏览器窗口的宽度
    • height（数字）：浏览器窗口的高度
  • 只读：false

• browser_run_code
  • 标题：运行 Playwright 代码
  • 描述：执行一段 Playwright 代码
  • 参数：
    • code（字符串，可选）：包含 Playwright 代码的 JavaScript 函数，用于执行。该函数将被调用一次，传入一个参数 page，可用于与页面进行任何交互。例如：async (page) => { await page.getByRole('button', { name: 'Submit' }).click(); return await page.title(); }
    • filename（字符串，可选）：从指定文件加载代码。如果同时提供了 code 和 filename，则会忽略 code。
  • 只读：false

• browser_select_option
  • 标题：选择选项
  • 描述：在下拉菜单中选择一个选项
  • 参数：
    • element（字符串，可选）：用于获取与元素交互权限的人类可读元素描述
    • ref（字符串）：来自页面快照的精确目标元素引用
    • selector（字符串，可选）：当没有“ref”时，用于定位目标元素的 CSS 或角色选择器
    • values（数组）：要在下拉菜单中选择的值列表。可以是单个值，也可以是多个值。
  • 只读：false

• browser_snapshot
  • 标题：页面快照
  • 描述：捕获当前页面的无障碍快照，这比截图更好
  • 参数：
    • filename（字符串，可选）：将快照保存为 Markdown 文件，而不是在响应中返回。
    • selector（字符串，可选）：用于捕获部分页面快照而非整个页面的根元素选择器
    • depth（数字，可选）：限制快照树的深度
  • 只读：true

• browser_take_screenshot
  • 标题：截取屏幕截图
  • 描述：截取当前页面的屏幕截图。你无法基于截图执行操作；若需执行操作，请使用 browser_snapshot。
  • 参数：
    • type（字符串）：截图的图像格式。默认为 png。
    • filename（字符串，可选）：保存截图的文件名。如果不指定，默认为 page-{timestamp}.{png|jpeg}。建议使用相对路径，以确保文件位于输出目录内。
    • element（字符串，可选）：用于获取对特定元素进行截图权限的人类可读元素描述。如果未提供，则对视口进行截图。如果提供了 element，则必须同时提供 ref。
    • ref（字符串，可选）：来自页面快照的精确目标元素引用。如果未提供，则对视口进行截图。如果提供了 ref，则必须同时提供 element。
    • selector（字符串，可选）：当没有“ref”时，用于定位目标元素的 CSS 或角色选择器
    • fullPage（布尔值，可选）：如果为 true，则截取整个可滚动页面的截图，而不是当前可见的视口。不能与针对特定元素的截图同时使用。
  • 只读：true

• browser_type
  • 标题：输入文本
  • 描述：在可编辑元素中输入文本
  • 参数：
    • element（字符串，可选）：用于获取与元素交互权限的人类可读元素描述
    • ref（字符串）：来自页面快照的精确目标元素引用
    • selector（字符串，可选）：当没有“ref”时，用于定位目标元素的 CSS 或角色选择器
    • text（字符串）：要输入到元素中的文本
    • submit（布尔值，可选）：是否提交输入的文本（输入后按 Enter 键）
    • slowly（布尔值，可选）：是否逐字符输入。这对于触发页面中的按键处理程序很有用。默认是一次性输入全部文本。
  • 只读：false

• browser_wait_for
  • 标题：等待
  • 描述：等待文本出现或消失，或者等待指定的时间过去
  • 参数：
    • time（数字，可选）：等待的时间，单位为秒
    • text（字符串，可选）：要等待出现的文本
    • textGone（字符串，可选）：要等待消失的文本
  • 只读：false

• browser_tabs
  • 标题：管理标签页
  • 描述：列出、创建、关闭或选择浏览器标签页。
  • 参数：
    • action（字符串）：要执行的操作
    • index（数字，可选）：标签页索引，用于关闭或选择。如果关闭时未指定索引，则关闭当前标签页。
    • url（字符串，可选）：新标签页要导航到的 URL，用于新建标签页。
  • 只读：false

• browser_get_config
  • 标题：获取配置
  • 描述：获取在合并 CLI 选项、环境变量和配置文件后的最终解析配置。
  • 参数：无
  • 只读：true

• browser_network_state_set
  • 标题: 设置网络状态
  • 描述: 将浏览器的网络状态设置为在线或离线。当处于离线状态时，所有网络请求都会失败。
  • 参数:
    • state (字符串): 设置为 "offline" 以模拟离线模式，设置为 "online" 以恢复网络连接
  • 只读: 否

• browser_route
  • 标题: 模拟网络请求
  • 描述: 设置一个路由来模拟匹配特定 URL 模式的网络请求
  • 参数:
    • pattern (字符串): 要匹配的 URL 模式（例如：**/api/users、**/*.{png,jpg}）
    • status (数字，可选): 要返回的 HTTP 状态码（默认值：200）
    • body (字符串，可选): 响应体（文本或 JSON 字符串）
    • contentType (字符串，可选): Content-Type 头信息（例如：application/json、text/html）
    • headers (数组，可选): 以 "Name: Value" 格式添加的头部信息
    • removeHeaders (字符串，可选): 需要从请求中移除的头部名称列表，用逗号分隔
  • 只读: 否

• browser_route_list
  • 标题: 列出网络路由
  • 描述: 列出所有当前激活的网络路由
  • 参数: 无
  • 只读: 是

• browser_unroute
  • 标题: 移除网络路由
  • 描述: 移除与指定模式匹配的网络路由（如果没有指定模式，则移除所有路由）
  • 参数:
    • pattern (字符串，可选): 要取消路由的 URL 模式（省略则移除所有路由）
  • 只读: 否

• browser_cookie_clear
  • 标题: 清除所有 Cookie
  • 描述: 清除浏览器中的所有 Cookie
  • 参数: 无
  • 只读: 否

• browser_cookie_delete
  • 标题: 删除指定 Cookie
  • 描述: 删除某个特定的 Cookie
  • 参数:
    • name (字符串): 要删除的 Cookie 名称
  • 只读: 否

• browser_cookie_get
  • 标题: 获取指定 Cookie
  • 描述: 根据 Cookie 名称获取特定的 Cookie
  • 参数:
    • name (字符串): 要获取的 Cookie 名称
  • 只读: 是

• browser_cookie_list
  • 标题: 列出所有 Cookie
  • 描述: 列出所有 Cookie（可选择按域名或路径过滤）
  • 参数:
    • domain (字符串，可选): 按域名过滤 Cookie
    • path (字符串，可选): 按路径过滤 Cookie
  • 只读: 是

• browser_cookie_set
  • 标题: 设置 Cookie
  • 描述: 设置一个带有可选标志的 Cookie（域名、路径、过期时间、HttpOnly、Secure、SameSite）
  • 参数:
    • name (字符串): Cookie 名称
    • value (字符串): Cookie 值
    • domain (字符串，可选): Cookie 的域名
    • path (字符串，可选): Cookie 的路径
    • expires (数字，可选): Cookie 的过期时间，以 Unix 时间戳表示
    • httpOnly (布尔值，可选): 是否将 Cookie 设置为 HttpOnly
    • secure (布尔值，可选): 是否将 Cookie 设置为安全
    • sameSite (字符串，可选): Cookie 的 SameSite 属性
  • 只读: 否

• browser_localstorage_clear
  • 标题: 清空 localStorage
  • 描述: 清空浏览器中的所有 localStorage 数据
  • 参数: 无
  • 只读: 否

• browser_localstorage_delete
  • 标题: 删除 localStorage 中的一项
  • 描述: 删除 localStorage 中的某一项数据
  • 参数:
    • key (字符串): 要删除的键名
  • 只读: 否

• browser_localstorage_get
  • 标题: 获取 localStorage 中的一项
  • 描述: 根据键名获取 localStorage 中的一项数据
  • 参数:
    • key (字符串): 要获取的键名
  • 只读: 是

• browser_localstorage_list
  • 标题: 列出所有 localStorage 数据
  • 描述: 列出所有 localStorage 的键值对
  • 参数: 无
  • 只读: 是

• browser_localstorage_set
  • 标题: 设置 localStorage 中的一项
  • 描述: 根据给定的键和值设置 localStorage 中的一项
  • 参数:
    • key (字符串): 要设置的键名
    • value (字符串): 要设置的值
  • 只读: 否

• browser_sessionstorage_clear
  • 标题: 清空 sessionStorage
  • 描述: 清空浏览器中的所有 sessionStorage 数据
  • 参数: 无
  • 只读: 否

• browser_sessionstorage_delete
  • 标题: 删除 sessionStorage 中的一项
  • 描述: 删除 sessionStorage 中的某一项数据
  • 参数:
    • key (字符串): 要删除的键名
  • 只读: 否

• browser_sessionstorage_get
  • 标题: 获取 sessionStorage 中的一项
  • 描述: 根据键名获取 sessionStorage 中的一项数据
  • 参数:
    • key (字符串): 要获取的键名
  • 只读: 是

• browser_sessionstorage_list
  • 标题: 列出所有 sessionStorage 数据
  • 描述: 列出所有 sessionStorage 的键值对
  • 参数: 无
  • 只读: 是

• browser_sessionstorage_set
  • 标题: 设置 sessionStorage 中的一项
  • 描述: 根据给定的键和值设置 sessionStorage 中的一项
  • 参数:
    • key (字符串): 要设置的键名
    • value (字符串): 要设置的值
  • 只读: 否

• browser_set_storage_state
  • 标题: 恢复存储状态
  • 描述: 从文件中恢复存储状态（Cookie、localStorage）。在恢复之前会清除现有的 Cookie 和 localStorage。
  • 参数:
    • filename (字符串): 要从中恢复存储状态的文件路径
  • 只读: 否

• browser_storage_state
  • 标题: 保存存储状态
  • 描述: 将存储状态（Cookie、localStorage）保存到文件中，以便日后使用
  • 参数:
    • filename (字符串，可选): 保存存储状态的文件名。如果未指定，则默认为 storage-state-{timestamp}.json
  • 只读: 是

• browser_resume
  • 标题: 恢复已暂停的脚本执行
  • 描述: 在脚本被暂停后恢复执行。当 step 参数设置为 true 时，执行将在下一个操作之前再次暂停。
  • 参数:
    • step (布尔值，可选): 如果为 true, 执行将在下一个操作前再次暂停，以便进行逐步调试。
    • location (字符串，可选): 在指定的 <文件>:<行> 处暂停执行，例如 "example.spec.ts:42"。
  • 只读: false

• browser_start_tracing
  • 标题: 开始跟踪
  • 描述: 开始记录跟踪信息
  • 参数: 无
  • 只读: true

• browser_start_video
  • 标题: 开始录制视频
  • 描述: 开始录制视频
  • 参数:
    • filename (字符串，可选): 保存视频的文件名。
    • size (对象，可选): 视频尺寸。
  • 只读: true

• browser_stop_tracing
  • 标题: 停止跟踪
  • 描述: 停止记录跟踪信息
  • 参数: 无
  • 只读: true

• browser_stop_video
  • 标题: 停止录制视频
  • 描述: 停止录制视频
  • 参数: 无
  • 只读: true

• browser_video_chapter
  • 标题: 视频章节
  • 描述: 在视频录制中添加一个章节标记。显示带有模糊背景的全屏章节卡片。
  • 参数:
    • title (字符串): 章节标题
    • description (字符串，可选): 章节描述
    • duration (数字，可选): 显示章节卡片的持续时间（以毫秒为单位）
  • 只读: true

• browser_mouse_click_xy
  • 标题: 点击
  • 描述: 在指定位置点击鼠标按钮
  • 参数:
    • x (数字): X 坐标
    • y (数字): Y 坐标
    • button (字符串，可选): 要点击的按钮，默认为左键
    • clickCount (数字，可选): 点击次数，默认为 1 次
    • delay (数字，可选): 鼠标按下和松开之间的时间间隔（以毫秒为单位），默认为 0 毫秒
  • 只读: false

• browser_mouse_down
  • 标题: 按下鼠标
  • 描述: 按下鼠标
  • 参数:
    • button (字符串，可选): 要按下的按钮，默认为左键
  • 只读: false

• browser_mouse_drag_xy
  • 标题: 拖动鼠标
  • 描述: 将左键拖动到指定位置
  • 参数:
    • startX (数字): 起始 X 坐标
    • startY (数字): 起始 Y 坐标
    • endX (数字): 终点 X 坐标
    • endY (数字): 终点 Y 坐标
  • 只读: false

• browser_mouse_move_xy
  • 标题: 移动鼠标
  • 描述: 将鼠标移动到指定位置
  • 参数:
    • x (数字): X 坐标
    • y (数字): Y 坐标
  • 只读: false

• browser_mouse_up
  • 标题: 松开鼠标
  • 描述: 松开鼠标
  • 参数:
    • button (字符串，可选): 要松开的按钮，默认为左键
  • 只读: false

• browser_mouse_wheel
  • 标题: 滚动鼠标滚轮
  • 描述: 滚动鼠标滚轮
  • 参数:
    • deltaX (数字): X 方向的滚动量
    • deltaY (数字): Y 方向的滚动量
  • 只读: false

• browser_pdf_save
  • 标题: 另存为 PDF
  • 描述: 将页面保存为 PDF
  • 参数:
    • filename (字符串，可选): 保存 PDF 的文件名。如果未指定，则默认为 page-{timestamp}.pdf。建议使用相对路径，以确保文件保存在输出目录内。
  • 只读: true

• browser_generate_locator
  • 标题: 为元素创建定位器
  • 描述: 为给定元素生成定位器，用于测试中
  • 参数:
    • element (字符串，可选): 人类可读的元素描述，用于获取与该元素交互的权限
    • ref (字符串): 页面快照中目标元素的精确引用
    • selector (字符串，可选): 目标元素的 CSS 或角色选择器，当没有 ref 时使用
  • 只读: true

• browser_verify_element_visible
  • 标题: 验证元素可见
  • 描述: 验证元素是否在页面上可见
  • 参数:
    • role (字符串): 元素的角色。可在快照中找到类似以下内容：- {ROLE} "Accessible Name":
    • accessibleName (字符串): 元素的可访问名称。可在快照中找到类似以下内容：- role "{ACCESSIBLE_NAME}"
  • 只读: false

• browser_verify_list_visible
  • 标题: 验证列表可见
  • 描述: 验证列表是否在页面上可见
  • 参数:
    • element (字符串): 人类可读的列表描述
    • ref (字符串): 指向列表的精确元素引用
    • selector (字符串，可选): 目标列表的 CSS 或角色选择器，当没有 ref 时使用
    • items (数组): 要验证的列表项
  • 只读: false

• browser_verify_text_visible
  • 标题: 验证文本可见
  • 描述: 验证文本是否在页面上可见。如果可能，建议优先使用 browser_verify_element_visible。
  • 参数:
    • text (字符串): 要验证的文本。可在快照中找到类似以下内容：- role "Accessible Name": {TEXT} 或 - text: {TEXT}
  • 只读: false

• browser_verify_value
  • 标题: 验证元素值
  • 描述: 验证元素的值
  • 参数:
    • type (字符串): 元素的类型
    • element (字符串): 人类可读的元素描述
    • ref (字符串): 页面快照中目标元素的精确引用
    • selector (字符串，可选): 目标元素的 CSS 或角色选择器，当没有 ref 时使用
    • value (字符串): 要验证的值。对于复选框，使用 "true" 或 "false"。
  • 只读: false