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想验证一个登录页却要反复切到 DevTools 里翻选择器再回编辑器手写定位器来回十几趟就烦了。如果直接在终端里驱动浏览器每做一次操作就顺手吐出一行对应的 Playwright TypeScript 呢playwright-cli干的就是这件事一条命令操作页面输出里自带可粘进测试文件的动作代码。这篇指南按“装好 → 跑通第一个任务 → 留证据 → 定制 → 排错”的顺序走一遍命令都可以直接复制执行。装好 Playwright CLI 与技能包环境要求 Node.js 18 及以上。拿到命令有三条路按场景选# 全局安装装完后在任意目录都能执行该命令 npm install -g playwright/clilatest # 只想临时跑一下、不落盘用 npx 拉起适合项目里已带本地版本的情况 npx --no-install playwright-cli --version # 安装技能包参考文档集放进 skills/playwright-cli/ 目录 # Claude Code、GitHub Copilot 等编码代理能照着它驱动浏览器 playwright-cli install --skills全局装的好处是调用零负担npx 这条路把版本钉在项目声明上不污染全局环境两条可以并存。技能包的价值在于代理不用教就会用——装完文档它自己会查手册干活。想自己翻的话入口是 技能主文档 SKILL.md。第一个自动化任务从打开页面到拿到定位器这个工具的交互套路很固定先取快照拿元素引用再凭引用操作每条命令的输出都带当前页面状态和对应的 Playwright TypeScript。# 新开浏览器并跳到目标页 playwright-cli open https://demo.playwright.dev/todomvc/ # 取一次快照输出里列出页面结构每个可操作元素带 e5 这样的引用 playwright-cli snapshot # 凭引用操作每一步的输出里同时给出等价的 Playwright 代码 playwright-cli fill e5 Buy groceries playwright-cli press Enter # 写测试时想要某个元素的稳定定位器直接对引用求 playwright-cli generate-locator e5 --raw为什么不直接猜选择器快照给出的引用在本次会话里保证可用省掉“元素找不到”的排查。generate-locator优先产出基于角色的定位器比 id 和层级路径稳--raw只打印结果值方便管道接给别的工具。快照里没显示、你又需要确认的 id 或># 截图不带参数拍整页传 ref 拍单个元素--filename 指定文件名 playwright-cli screenshot playwright-cli screenshot e5 playwright-cli screenshot --filenamepage.png # 录视频成对出现产出 WebM 文件 playwright-cli video-start recordings/login-flow.webm playwright-cli video-stop # 开追踪记录 DOM 状态、网络请求与控制台输出 playwright-cli tracing-start playwright-cli tracing-stop截图最快用来确认结果、把页面状态发给同事核对。视频记录完整过程适合做演示和文档想分章节、给动作加标注看video-chapter这类进阶选项在 video-recording 参考文档。追踪面向排障它存下每次动作前后的 DOM、网络请求与控制台输出能用 Trace Viewer 逐步回放文件比视频小。拿不准就用一条粗规则给人看就录视频查某一步为什么失败就开追踪详见 tracing 参考文档。无头模式、配置文件与登录态定制在哪改最常动的是这三处一次配置管到底# 想看浏览器窗口open 时加 --headed默认无头不弹窗口 playwright-cli open https://playwright.dev --headed # 指定自定义配置文件不指定时默认加载项目下的 .playwright/cli.config.json playwright-cli --configmy-config.json open example.com # 把浏览器 profile 写到磁盘默认只在内存里浏览器一关 cookie 就丢 playwright-cli open https://example.com --persistent # 多个项目各开各的浏览器用 -s 会话名隔离 playwright-cli -sshop open https://shop.example.com playwright-cli list无头模式怎么切默认无头运行不开窗口、跑得快CI 这种没有图形环境的地方也照跑。本地调试想盯着看就在open上加--headed窗口随即弹出。配置文件放哪配置文件是 JSON 格式默认位置是项目下的.playwright/cli.config.json不传路径时自动加载。里面能设浏览器种类、是否保存视频、输出目录、动作与导航超时等参数某个参数在项目里统一后写进配置就不用每次敲命令时再拼一遍。登录态存哪浏览器 profile 默认只活在内存里关掉后 cookie 和存储状态全丢。两种解法--persistent把 profile 落盘重启浏览器后登录仍在只想复用登录态时登录后state-save auth.json存一次下次state-load auth.json直接跳过登录流程详见 storage-state 参考文档。多个项目并行时用-s隔离实例playwright-cli list查看全部会话close-all、kill-all负责统一清理见 session-management 参考文档。排错速查 Playwright MCP 和 CLI 怎么取舍一句话MCP 面向需要常驻浏览器上下文、持续内省页面的场景比如探索式自动化和长时任务CLI 面向编码代理里的短平快调用命令精简不把页面数据塞进模型上下文省 token。对比细节见 README.md。怎么升级到最新版# 把全局安装升到最新 npm update -g playwright/cliCI/CD 流水线里能用吗可以。默认无头、不依赖显示器直接挂进自动化测试环节就行。装完找不到命令先用npx --no-install playwright-cli --version试本地版本项目里有本地版本时后续调用统一走npx playwright-cli保证和项目声明的版本一致。下一步先跑npm install -g playwright/clilatest再用playwright-cli open https://example.com打开任意页面接一条snapshot“操作 → 拿代码”的循环就通了。【免费下载链接】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），仅供参考