用途:在真实运行的 Electron 应用中验证 UI 改动、复现渲染进程或启动缺陷(含更严格 CSP 等仅生产构建出现的问题),检查首次运行、引导和设置界面,或端到端走通含 preload IPC 与主进程代码的功能。不适用于非 Electron 的 Web 应用,也不支持多窗口流程。
主要能力:scripts/drive.mjs 在后台守护进程中用 Playwright 启动应用并在命令间保持运行,每条命令都是一次快速 shell 调用。命令包括 start、snapshot(可访问性树,按角色和名称定位)、click、fill、select、press、wait、screenshot、logs、eval(渲染进程)、main(主进程)、status、stop。整体只监听 127.0.0.1,使用随机会话令牌,不向第三方发送数据。
必要用法:需在项目内安装 electron 和 playwright-core 1.49+,Node.js 18+;脚本按最近的 package.json 定位项目,需把 DR 设为脚本绝对路径。常用示例: $DR start $DR snapshot $DR click 'role=button[name="Get started"]' $DR fill 'role=textbox[name="Email"]' 'test@example.com' $DR logs --lines 80 $DR stop start 支持 --build(先执行构建)、--fresh(清空临时 profile,得到首次运行状态)、--profile <name>、--dev。目标使用 Playwright 选择器,优先 role=…[name=…],其次 text=,最后 CSS。以 -- 结尾标志,可传入以短横线开头的文本。eval 结果以 JSON 返回,需返回纯数据。可选在项目根放置 drive.config.json,配置 build、args、env(值中 {profile} 会替换为临时 profile 目录)、logFile 及 dev 的 args/env/url。
限制:只操作第一个非 DevTools 窗口,无法选择其他窗口;每项目同时只能运行一个实例;Windows 需以 node scripts/drive.mjs 运行,stop 回退的进程树终止仅适用于 POSIX;每个启动使用 $TMPDIR/electron-drive 下的临时 userData,但应用存于其他位置的数据只有通过配置 env 才能重定向,运行前应确认,若会触碰真实用户文件须停下告知用户。eval 和 main 以应用权限运行任意代码,主进程有完整 Node 权限,只运行任务所需代码,删除文件或对外网络调用需用户确认。还应先看再操作、每步后查 [renderer:error] 与 [renderer:pageerror]、优先生产构建、始终 stop;不要使用 yarn drive 等包装脚本,也不要自行安装依赖。它不能替代项目测试套件和人工视觉检查。