让浏览器替你写 Playwright 测试playwright-cli 上手指南【免费下载链接】playwright-cliCLI for common Playwright actions. Record and generate Playwright code, inspect selectors and take screenshots.项目地址: https://gitcode.com/GitHub_Trending/pl/playwright-cli写过 Playwright 测试的人都清楚真正拖时间的往往不是断言逻辑而是选择器页面一改版getByRole就失灵你又得翻 DOM 找定位、反复调试。playwright-cli 把这件事反了过来——你在命令行里直接操作浏览器它顺手把每一步都翻译成现成的 Playwright TypeScript 代码还负责检查选择器、截屏。省掉手写定位器和反复试错的功夫。更妙的是它能挂到 Claude Code、GitHub Copilot 这类编码代理上让 AI 替你点页面、跑流程。下面按真实使用顺序从安装到跑通再到把浏览器交给 AI。3 步跑通 playwright-cli打开页面、点击、拿到代码先把全局命令装上之后在任何目录都能敲playwright-cli。装前确保 Node.js 是 18 或更高。npm install -g playwright/clilatest跑完安装成功再敲playwright-cli --help能看到 open、click、snapshot、route、tracing 等 60 多条子命令。接下来做最核心的三件事打开页面、取快照、点对元素。playwright-cli open https://demo.playwright.dev/todomvc/ playwright-cli snapshot playwright-cli click e5打开后你会看到页面标题、URL 和一份带e1、e2这种编号的页面快照最后一步的输出里还会附带一行await page.getByRole(...).click()形式的代码——直接粘进测试文件就能用。这套点完即得代码的机制是这个工具最省时间的地方。用快照 ref 操作页面不用手写选择器什么时候用每次要定位页面元素时。为什么有用ref 由快照实时生成比你自己记的 class、id 更稳页面小改也不容易断。snapshot会给页面上每个可交互元素一个临时编号你拿编号操作即可。playwright-cli snapshot跑完会看到e1 [textbox ...]、e2 [button ...]这样的列表照着编号playwright-cli click e15就行。页面大、想直接定位某个文本对应的 ref用find搜比翻整份快照快。playwright-cli find Sign in它会返回匹配节点加前后 3 行上下文体验类似grep -C。如果你手上已有选择器也能直接传比如playwright-cli click getByRole(button, { name: Submit })三种定位方式ref / CSS / Playwright locator随便混用。一条命令装 skills让 AI 驱动浏览器什么时候用你已经在用 Claude Code、GitHub Copilot 等编码代理想让它替你跑浏览器流程。为什么有用CLI 式调用比 MCP 更省 token——它不把整棵可访问性树塞进模型上下文而是用短小、目的明确的命令操作页面适合在有限上下文里兼顾大代码库和浏览器自动化。一条命令把技能包装上代理就会自己读命令、驱动浏览器。playwright-cli install --skills装完项目里会多出skills/playwright-cli/目录里面是按任务拆好的参考文档如 测试生成、跟踪记录代理会照着执行。完整说明见 SKILL.md。不想装技能也行——直接把代理指向 CLI让它自己读playwright-cli --help用 playwright-cli 测试 https://demo.playwright.dev/todomvc 的添加待办流程先读 playwright-cli --help 看可用命令。多会话、登录态持久化与可视化监控什么时候用多项目并行、需要保持登录、或代理在后台跑而你想随时观察接管。为什么有用会话隔离互不串号持久化让登录不丢监控面板让你能亲眼盯着甚至伸手接管。用-s命名就能同时开多个隔离浏览器每个会话有独立的 cookies、localStorage 和标签页。playwright-cli -sauth open https://app.example.com/login默认浏览器 profile 存在内存里浏览器一关登录就丢。想跨重启保留加--persistentplaywright-cli -sauth open https://app.example.com/login --persistent会话日常管理playwright-cli list看所有会话close-all关掉全部浏览器kill-all强杀残留进程。默认是无头模式想亲眼看着浏览器跑open时加--headed。代理在后台驱动浏览器时这条命令打开可视化面板能看到每个会话的实时画面点进去还能接管鼠标键盘。playwright-cli show要固定浏览器、视口、超时放一个.playwright/cli.config.jsonCLI 会自动读取临时改就playwright-cli --configmy-config.json open ...。产出调试件截图、视频、跟踪记录与登录态保存什么时候用要留证、排查失败、或复用登录态。为什么有用这些产出都是排错和交接的硬证据且动作本身仍在生成 TS 代码。留一张页面或元素的截图playwright-cli screenshot --filenamepage.png跑完会在输出目录生成page.png。测试失败想看每一步的 DOM、网络和控制台开一段跟踪playwright-cli tracing-start操作完执行tracing-stop会在traces/里生成含每步快照、请求与日志的 trace 文件细节见 跟踪记录文档。想录下完整操作过程playwright-cli video-start login.webm结束时video-stop中间还能video-chapter 登录打章节点。登录一次后把登录态存盘下次直接加载免得每次填账号playwright-cli state-save auth.json之后playwright-cli state-load auth.json即可恢复更多存储用法见 存储状态文档。高频疑问CLI 还是 MCP、CI 使用、Windows 坑CLI 和 Playwright MCP 怎么选CLI 面向编码代理token 更省适合高吞吐的浏览器自动化MCP 更适合需要持续状态、反复探查页面结构的探索式或长时自治流程。两者不冲突看你的代理形态。装不上全局命令项目里已装本地版本时用npx --no-install playwright --version探一下可用就全程把命令换成npx playwright cli否则再全局装。能在 CI/CD 里用吗能。它默认无头正好适合流水线里静默跑需要录证再开tracing/video即可。Windows 下 URL 带被截断cmd里用^转义PowerShell 里用--%例如playwright-cli --% goto https://example.com/?a1b2。怎么升级到最新重跑npm install -g playwright/clilatest即可。下一步很简单挑一个你天天点的页面用上面3 步跑通那段跑一遍把生成的代码贴进你的测试文件。等你能顺手让 AI 替你点完一轮流程这个工具就真正上手了。【免费下载链接】playwright-cliCLI for common Playwright actions. Record and generate Playwright code, inspect selectors and take screenshots.项目地址: https://gitcode.com/GitHub_Trending/pl/playwright-cli创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考