命令参考

🌐 Command Reference

下面的每个命令始终可用——不像 MCP，CLI 没有功能限制。分组与 playwright-cli --help 打印的一致；使用 playwright-cli --help <command> 查看单个命令的具体参数和选项。

🌐 Every command below is always available — unlike MCP, the CLI has no capability gating. The groups match the ones printed by playwright-cli --help; use playwright-cli --help <command> for the exact arguments and options of a single command.

<angle brackets> 中的参数是必需的，[square brackets] 中的参数是可选的。

🌐 Arguments in <angle brackets> are required, arguments in [square brackets] are optional.

核心

🌐 Core

命令	描述
open [url]	打开浏览器，可选择导航到某个网址
attach [name]	附加到正在运行的 Playwright 浏览器
close	关闭浏览器
detach	从已附加的浏览器分离，但保持其运行
goto <url>	导航到一个网址
type <text>	在当前聚焦的可编辑元素中输入文本
click <target> [button]	点击一个元素
dblclick <target> [button]	双击一个元素
fill <target> <text>	在可编辑元素中填写文本
drag <startTarget> <endTarget>	在两个元素之间拖放
drop <target>	将文件或数据从页面外拖放到元素上
hover <target>	悬停在一个元素上
select <target> <val>	在下拉菜单中选择一个选项
upload <files...>	上传一个或多个文件
check <target> / uncheck <target>	选中或取消选中复选框或单选按钮
snapshot [target]	捕捉页面快照以获取元素引用
find [text]	搜索页面快照，返回带上下文的匹配
eval <func> [target]	在页面或某个元素上执行 JavaScript
dialog-accept [prompt] / dialog-dismiss	处理对话
resize <w> <h>	调整浏览器窗口大小
delete-data	删除会话的用户数据

请参见 交互、导航 和 对话框。

🌐 See Interaction, Navigation and Dialogs.

导航

🌐 Navigation

命令	描述
go-back	返回上一页
go-forward	前进到下一页
reload	重新加载当前页面

Keyboard

命令	描述
press <key>	按一个键，例如 Enter 或 ArrowLeft
keydown <key> / keyup <key>	按下或松开一个键

Mouse

基于坐标的交互，使用截图中的像素位置。适用于画布应用、地图和没有可访问元素的自定义小部件。

🌐 Coordinate-based 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>	使用鼠标滚轮滚动

查看 视觉模式。

🌐 See Vision Mode.

另存为

🌐 Save as

命令	描述
screenshot [target]	截取页面或元素的截图
pdf	将页面保存为 PDF

查看 截图和 PDF。

🌐 See Screenshots & PDF.

标签

🌐 Tabs

命令	描述
tab-list	列出所有标签页
tab-new [url]	创建一个新标签页
tab-close [index]	关闭一个标签页（如果没有指定索引则关闭当前标签页）
tab-select <index>	切换到某个标签页

查看 标签。

🌐 See Tabs.

存储

🌐 Storage

命令	描述
state-save [filename] / state-load <filename>	保存或恢复浏览器存储状态
cookie-list、cookie-get、cookie-set、cookie-delete、cookie-clear	管理 Cookies
localstorage-list/get/set/delete/clear	管理 localStorage
sessionstorage-list/get/set/delete/clear	管理 sessionStorage

请查看 存储与认证。

🌐 See Storage & Authentication.

网络

🌐 Network

命令	描述
requests	列出网络请求，并编号以便与 request 使用
request <index>	查看单个请求的完整详情
request-headers <index> / request-body <index>	请求的一部分
response-headers <index> / response-body <index>	响应的一部分
route <pattern>	模拟匹配某个 URL 模式的请求
route-list	列出活跃的路由
unroute [pattern]	删除匹配的路由，或全部删除
network-state-set <state>	设置浏览器在线或离线

查看 网络与模拟。

🌐 See Network & Mocking.

DevTools

命令	描述
console [min-level]	列出控制台消息
run-code [code]	运行 Playwright 代码片段
recording-start / recording-stop	记录用户操作并以 Playwright 代码打印
tracing-start / tracing-stop	记录执行跟踪
video-start [filename] / video-stop	录制视频
video-chapter <title>	在视频中添加章节标记
video-show-actions / video-hide-actions	在录制的视频中标注操作
show	打开 Playwright 仪表板
pause-at <location>、resume、step-over	控制暂停的测试
generate-locator <target>	为元素生成 Playwright 定位器
highlight [target]	显示或隐藏页面高亮覆盖层

查看 控制台与评估、代码生成与高亮、跟踪、视频录制 以及 测试调试。

🌐 See Console & Eval, Codegen & Highlighting, Tracing, Video Recording and Test Debugging.

安装

🌐 Install

命令	描述
install	初始化工作区，可选择安装技能
install-browser [browser]	安装浏览器

查看安装。

🌐 See Installation.

浏览器会话

🌐 Browser sessions

命令	描述
list	列出浏览器会话
close-all	关闭所有浏览器会话
kill-all	强制结束僵尸或过期的浏览器进程

查看 会话和仪表板。

🌐 See Sessions & Dashboard.

全局选项

🌐 Global options

这些适用于每个命令，并且可以放在命令行的任何地方。

🌐 These apply to every command and can be placed anywhere on the command line.

选项	描述
-s=<name>、--session=<name>	在指定的浏览器会话中运行
--raw	只打印结果值，不显示页面状态、生成的代码或快照
--json	将整个回复封装为 JSON
--help [command]	打印帮助信息
--version	打印版本信息

# pipe a value straight into another tool
playwright-cli --raw eval "JSON.stringify(performance.timing)" | jq '.loadEventEnd - .navigationStart'
playwright-cli --raw snapshot > before.yml

# structured output for scripting
playwright-cli list --json