能力
🌐 Capabilities
CLI 和 MCP 共享相同的底层 Playwright 工具，这些工具被组织到不同的功能组中。在 CLI 中，所有功能始终可用——没有任何限制。本页面将命令映射到其功能组，供参考。
🌐 The CLI and MCP share the same underlying Playwright tools, organized into capability groups. In the CLI all capabilities are always available — there's no gating. This page maps commands to their capability groups for reference.
核心
🌐 Core
始终可用。基本浏览器自动化。
🌐 Always available. Basic browser automation.
| 命令 | 描述 |
|---|---|
open, goto, close | 打开、导航、关闭浏览器 |
go-back, go-forward, reload | 历史记录导航 |
click, dblclick, hover, drag | 元素交互 |
type, fill, select | 文本输入和下拉菜单 |
check, uncheck | 复选框和单选按钮 |
press, keydown, keyup | 键盘输入 |
snapshot | 捕获无障碍树 |
screenshot | 截屏 |
upload | 上传文件 |
dialog-accept, dialog-dismiss | 处理对话框 |
resize | 调整浏览器窗口大小 |
eval, run-code | 执行 JavaScript / Playwright 代码 |
网络
🌐 Network
网络检查和模拟。
🌐 Network inspection and mocking.
| 命令 | 描述 |
|---|---|
network | 列出自页面加载以来的网络请求 |
route | 模拟匹配 URL 模式的请求 |
route-list | 列出活跃的模拟路由 |
unroute | 移除模拟路由 |
network-state-set | 设置在线/离线状态 |
有关用法，请参见 网络与模拟。
🌐 See Network & Mocking for usage.
存储
🌐 Storage
Cookie、本地存储和会话存储管理以及状态持久化。
🌐 Cookie, localStorage, and sessionStorage management plus state persistence.
| 命令 | 描述 |
|---|---|
state-save, state-load | 保存/恢复完整浏览器状态 |
cookie-list/get/set/delete/clear | 管理 Cookies |
localstorage-list/get/set/delete/clear | 管理 localStorage |
sessionstorage-list/get/set/delete/clear | 管理 sessionStorage |
有关使用方法，请参见 存储与认证。
🌐 See Storage & Authentication for usage.
视力
🌐 Vision
使用屏幕截图中的像素位置进行基于坐标的鼠标交互。适用于画布应用、地图和没有可访问元素的自定义小部件。
🌐 Coordinate-based mouse interaction using pixel positions from screenshots. Useful for canvas apps, maps, and custom widgets without accessible elements.
| 命令 | 描述 |
|---|---|
mousemove <x> <y> | 将鼠标移动到坐标 |
mousedown [button] | 按下鼠标按钮 |
mouseup [button] | 释放鼠标按钮 |
mousewheel <dx> <dy> | 滚动鼠标滚轮 |
screenshot | 捕获视口以作为坐标参考 |
请参阅 Vision Mode 了解何时以及如何使用基于坐标的交互。
🌐 See Vision Mode for when and how to use coordinate-based interaction.
DevTools
跟踪、视频录制和测试调试。
🌐 Tracing, video recording, and test debugging.
| 命令 | 描述 |
|---|---|
console | 查看控制台消息 |
tracing-start, tracing-stop | 记录执行跟踪 |
video-start, video-stop, video-chapter | 录制会话视频 |
show | 打开可视化仪表板 |
pause-at, resume, step-over | 测试调试 |
PDF
PDF 生成。
🌐 PDF generation.
| 命令 | 描述 |
|---|---|
pdf | 将页面导出为 PDF |
测试
🌐 Testing
断言和测试生成工具。
🌐 Assertions and test generation tools.
| 命令 | 描述 |
|---|---|
verify-element-visible | 断言元素通过角色和名称可见 |
verify-text-visible | 断言文本可见 |
verify-list-visible | 断言包含项目的列表可见 |
verify-value | 断言表单字段的值 |
generate-locator | 为测试代码生成 Playwright 定位器 |