v16: 迁移 playwright-cli → playwright Node.js 包 + AI wrapper

playwright-cli (2026-06-15 @playwright/cli 废弃):
- init.js / init.sh 移除 @playwright/cli 安装+软链步骤
- npm install -g playwright (Node.js 包) 替代 @playwright/cli
- 本地 5 行 wrapper .claude/hooks/playwright-ai-cli.js 复刻 @playwright/cli
  (用 playwright-core/lib/tools/cli-client/program 入口, 零额外依赖)
- /usr/local/bin/playwright → 软链到 wrapper
- 标准 test/codegen 走 npx playwright (npm bin 仍可用)

文档/命令:
- CLAUDE.md, ssw-test.md, ssw-h5dev-flow.md, ssw-e2e-test/SKILL.md,
  troubleshooting, api-test 全部 playwright-cli → playwright
- auto-push-on-stop.sh JUNK_PATTERNS 加 .playwright/ 目录过滤

验证 (per 用户"注意验证有效性"):
- node init.js / bash init.sh 幂等通过 (再跑也 OK)
- playwright --version 返 1.60.0
- playwright -s=smoke open/snapshot/click/close 全部工作
- snapshot YAML 输出含 ref (e1/e2/e3), AI 可直接用
- 标准 CLI 仍可达: npx playwright --version
This commit is contained in:
ssw committed 2026-06-15 11:56:39 +08:00
1 parent c9878c25ab
commit fee91b6ccc
10 files changed
+179 -111

No files matched your search

+2 -2
View File
@@ -362,8 +362,8 @@ alias dacli='npx tsx $ccWorkDir/dacli/src/cli.ts'
cd $ccWorkDir/dacli && npm install # 首次需装依赖
dacli app login --account=admin --password=123456 --appCode=developSystem
# E2E测试(playwright-cli)
cd $ccWorkDir/test && playwright-cli test --project=chromium
# E2E测试(playwright Node.js)
cd $ccWorkDir/test && npx playwright test --project=chromium
```
---
+1 -1
View File
@@ -305,7 +305,7 @@ dacli app status # 确认登录状态
2. 根据测试用例逐项验证
3. **测试框架**:
- API 集成测试:`curl + jq` 或 `dacli form/menu/... list`(无需启动前端,详见 `api-test` 技能)
- E2E 测试:`playwright-cli -s=dacli open ... && playwright-cli -s=dacli eval ...`(详见 `ssw-e2e-test` 技能)
- E2E 测试:`playwright -s=dacli open ... && playwright -s=dacli eval ...`(详见 `ssw-e2e-test` 技能)
4. 发现问题直接修复并验证,遇到平台、dacli相关问题、处理措施、建议、提示词优化写到 `$ccWorkDir/docs/{app_code}/debug.html`
### 阶段6: 总结
+24 -22
View File
@@ -1,6 +1,6 @@
---
skill: ssw-e2e-test
description: JNPF E2E + API 测试(基于 playwright-cli + curl + dacli)
description: JNPF E2E + API 测试(基于 playwright Node.js + curl + dacli)
triggerWords: [ssw-test, e2e, 表单测试, 功能测试, 测试表单, e2e测试, 浏览器测试, api测试]
autoTrigger: false
---
@@ -8,44 +8,46 @@ autoTrigger: false
# SSW E2E + API Testing
JNPF 测试工具集:
- **UI 自动化**:playwright-cli 直接调(无 dacli 包装)
- **UI 自动化**:playwright Node.js 版 CLI 直接调(无 dacli 包装)
- **API 验证**:curl + jq + dacli 业务命令
> 📦 **2026-06-05 变更**:dacli 不再包装 curl / playwright-cli(移除 `dacli test` / `dacli e2e`)。
> 📦 **2026-06-05 变更**:dacli 不再包装 curl / playwright(移除 `dacli test` / `dacli e2e`)。
>
> 📦 **2026-06-15 变更**:从 `@playwright/cli` 迁移到 `playwright` Node.js 包,命令 `playwright-cli` → `playwright`(同一 `playwright-core` CLI program,session 模式 `playwright -s=X ...` 不变)。
## 双模式测试架构
| 场景 | 工具 | 说明 |
|------|------|------|
| 浏览器 UI 自动化 | `playwright-cli -s=dacli ...` | Playwright CLI,UI 操作测试 |
| 浏览器 UI 自动化 | `playwright -s=dacli ...` | Playwright Node.js 版 CLI,UI 操作测试 |
| API 验证 | `curl + jq` + `dacli <业务命令>` | 调 JNPF 后端接口 |
## playwright-cli 基本模式
## playwright 基本模式
**所有调用都用 `-s=dacli` 共享 session**:
```bash
# 启动
playwright-cli -s=dacli open "http://nginx/jnpf_app_tds/login"
playwright -s=dacli open "http://nginx/jnpf_app_tds/login"
# 登录
playwright-cli -s=dacli fill "#form_item_account" "admin"
playwright-cli -s=dacli fill "#form_item_password" "123456"
playwright-cli -s=dacli click "button:has-text('登 录')"
playwright -s=dacli fill "#form_item_account" "admin"
playwright -s=dacli fill "#form_item_password" "123456"
playwright -s=dacli click "button:has-text('登 录')"
# 菜单/点击/填写/截图
playwright-cli -s=dacli click ".jnpf-menu-item:has-text('用户管理')"
playwright-cli -s=dacli fill "#f_name" "测试值"
playwright-cli -s=dacli screenshot "/tmp/screen.png"
playwright -s=dacli click ".jnpf-menu-item:has-text('用户管理')"
playwright -s=dacli fill "#f_name" "测试值"
playwright -s=dacli screenshot "/tmp/screen.png"
# 执行 JS
playwright-cli -s=dacli eval "() => document.title"
playwright -s=dacli eval "() => document.title"
# 控制台
playwright-cli -s=dacli console
playwright -s=dacli console
# 关闭
playwright-cli -s=dacli close
playwright -s=dacli close
```
底层子命令:`open`, `goto`, `click`, `fill`, `select`, `eval`, `type`, `console`, `snapshot`
@@ -94,7 +96,7 @@ curl -s "$BASE/api/visualdev/Base/$FORM_ID" \
| `dacli user list` | `curl /api/permission/User/list` |
| `dacli tool logs --level=error` | `curl /api/ssw/system/logs` |
## 常用 JS 模式(playwright-cli eval)
## 常用 JS 模式(playwright eval)
### 点击菜单
```javascript
@@ -149,14 +151,14 @@ dacli app login --account=admin --password=123456 --appCode=tds
curl -s "http://127.0.0.1:30000/api/visualdev/Base/list" \
-H "App-Code: tds" -H "Authorization: $TOKEN" | jq '.data.list | length'
# 3. UI 测试新增(playwright-cli)
playwright-cli -s=dacli open "http://nginx/jnpf_app_tds/"
playwright-cli -s=dacli eval "() => {
# 3. UI 测试新增(playwright)
playwright -s=dacli open "http://nginx/jnpf_app_tds/"
playwright -s=dacli eval "() => {
document.querySelectorAll('.jnpf-menu-item').forEach(item => {
if (item.innerText.includes('数据资产')) { item.click(); return; }
});
}"
playwright-cli -s=dacli click "button:has-text('新 增')"
playwright -s=dacli click "button:has-text('新 增')"
# ... 填写表单,保存 ...
# 4. API 验证数据
@@ -168,8 +170,8 @@ curl -s "http://127.0.0.1:30000/api/visualdev/Base/$FORM_ID" \
| 问题 | 解决 |
|------|------|
| 菜单点击无效 | `playwright-cli -s=dacli eval` + JS `element.click()` |
| 下拉选项无法点击 | 用 `playwright-cli -s=dacli eval` 取坐标后 `mouse click` |
| 菜单点击无效 | `playwright -s=dacli eval` + JS `element.click()` |
| 下拉选项无法点击 | 用 `playwright -s=dacli eval` 取坐标后 `mouse click` |
| 表格无数据 | curl + jq 验证 API 返回 |
| 登录失败 | `dacli app login` 先确保登录成功 |
| 密码加密 | JNPF 前端用 MD5+AES 加密,`dacli app login` 自动处理 |
+2 -2
View File
@@ -6,7 +6,7 @@
#
# 设计原则:
# 1. **保守优先** — 默认只 commit tracked 文件的修改/删除(git add -u),
# untracked 文件默认不推(防止 .playwright-cli/ 之类的历史遗留污染)。
# untracked 文件默认不推(防止 .playwright-cli/ / .playwright/ 之类的历史遗留污染)。
# 2. **安全门** — 变更文件数 / 体积超过阈值就跳过 + 警告,不阻塞 Stop。
# 3. **失败兜底** — push 失败不阻塞 Claude 退出(脚本末尾 || true)。
# 4. **可观测** — 写日志到 .claude/logs/auto-push-{date}.log,每次 push 都有记录。
@@ -45,7 +45,7 @@ ALLOW_GLOBS="${AUTOPUSH_ALLOW_GLOBS:-}"
# 路径黑名单:build/cache/状态类目录,绝不纳入 commit
# (用 grep -E 模式,子串匹配路径中任一段即命中)
JUNK_PATTERNS='(/\.git/|/node_modules/|/target/|/build/|/dist/|/\.gradle/|/__pycache__/|/\.idea/|/\.vscode/|\.pnpm-store/|\.playwright-cli/|\.omc/|/\.claude/logs/|/\.playwright-mcp/|/history-bak/|/\.dacli-token/|/\.auth/|/test-results/|/playwright-report/|/screenshots/|\.DS_Store$|\.log$|\.swp$|~$|/tmp/)'
JUNK_PATTERNS='(/\.git/|/node_modules/|/target/|/build/|/dist/|/\.gradle/|/__pycache__/|/\.idea/|/\.vscode/|\.pnpm-store/|\.playwright-cli/|\.playwright/|\.omc/|/\.claude/logs/|/\.playwright-mcp/|/history-bak/|/\.dacli-token/|/\.auth/|/test-results/|/playwright-report/|/screenshots/|\.DS_Store$|\.log$|\.swp$|~$|/tmp/)'
# 6 个 gitea 仓库(hardcoded:仅这 6 个会推)
# - .claude 自身就是一个 gitea 仓库(gitea:3000/ssw/claude-config.git),
+42 -29
View File
@@ -4,9 +4,8 @@
*
* 职责(全部幂等,可重复执行):
* 1. 把 dacli 可执行入口放到 /usr/local/bin/dacli(TS 版 wrapper)
* 2. 保证 playwright Node.js 库(npm 包)已安装
* 3. 保证 playwright-cli 软链可用(e2e 技能 ssw-e2e-test 兼容)
* 4. 保证 google-chrome 已就绪(playwright install chrome 兜底)
* 2. 保证 playwright Node.js 库(npm `playwright` 包)已安装 + bin 软链
* 3. 保证 google-chrome 已就绪(playwright install chrome 兜底)
*
* 触发:Dockerfile CMD 链式调用,容器首次启动时执行一次
* 输出:每步一行状态(容器 stdout,docker logs 可看)
@@ -15,11 +14,13 @@
* - 不阻塞 JNPF 启动:网络操作(npm install / playwright install)失败用 try/catch 兜底
* - 不删任何文件,幂等追加 alias(先 filter 清掉旧的同名行)
*
* v15 变更(2026-06-12):
* - 改用 playwright Node.js 库(npm `playwright` 包),不再依赖 @playwright/cli
* - 用 Node.js 实现(原 init.sh 改薄包装,调用本文件)
* - Chrome 安装走 `npx playwright install chrome`(playwright 库自带 CLI)
* - playwright-cli 软链保留(ssw-e2e-test 技能仍用 `playwright-cli -s=dacli ...`)
* v16 变更(2026-06-15):
* - 移除 @playwright/cli 包依赖(彻底废弃)
* - 统一用 playwright Node.js 库(npm `playwright` 包)的 playwright-core 子模块
* - AI session 模式走本地 wrapper:`$ccWorkDir/.claude/hooks/playwright-ai-cli.js`
* (5 行复刻 @playwright/cli:require playwright-core/lib/tools/cli-client/program + program())
* - /usr/local/bin/playwright → 软链到 wrapper,覆盖 npm 标准 bin(标准 test/codegen 用 npx)
* - 验证:`playwright --version` 返 1.x;`playwright -s=X open URL` session 命令工作
*/
const { execSync, spawnSync } = require('child_process');
@@ -32,8 +33,9 @@ const BASHRC = path.join(HOME, '.bashrc');
const DACLI_SRC = path.join(CCWORKDIR, 'dacli/src/cli.ts');
const DACLI_LINK = '/usr/local/bin/dacli';
const PLAYWRIGHT_LIB_DIR = '/usr/lib/node_modules/playwright';
const PLAYWRIGHT_CLI_BIN = '/usr/lib/node_modules/@playwright/cli/playwright-cli.js';
const PLAYWRIGHT_CLI_LINK = '/usr/local/bin/playwright-cli';
const PLAYWRIGHT_BIN = path.join(PLAYWRIGHT_LIB_DIR, 'cli.js');
const PLAYWRIGHT_LINK = '/usr/local/bin/playwright';
const PLAYWRIGHT_AI_CLI = path.join(CCWORKDIR, '.claude/hooks/playwright-ai-cli.js');
const log = (msg) => console.log(`[init.js] ${msg}`);
@@ -68,39 +70,50 @@ log(` ✅ ${tryExec('command -v dacli') || '(未在 PATH 中)'}`);
// ==================== 2. playwright Node.js 库 ====================
log('② 检查 playwright Node.js 库 (npm `playwright`)');
if (fs.existsSync(PLAYWRIGHT_LIB_DIR)) {
const version = tryExec('npx playwright --version') || '(unknown)';
log(` ✅ 已存在: ${PLAYWRIGHT_LIB_DIR} (${version})`);
if (fs.existsSync(PLAYWRIGHT_BIN)) {
const version = tryExec('playwright --version') || tryExec('npx playwright --version') || '(unknown)';
log(` ✅ 已存在: ${PLAYWRIGHT_BIN} (${version})`);
} else {
log(' ⏳ 安装 playwright Node.js 库 ...');
const r = spawnSync('npm', ['install', '-g', 'playwright'], { stdio: 'ignore' });
if (r.status === 0) {
const version = tryExec('npx playwright --version') || '';
const version = tryExec('playwright --version') || tryExec('npx playwright --version') || '';
log(` ✅ 安装完成 (${version})`);
} else {
log(' ⚠️ 安装失败(继续,后续步骤不阻塞)');
}
}
// ==================== 3. playwright-cli 软链(e2e 技能兼容) ====================
log('③ 检查 playwright-cli 软链 (ssw-e2e-test 兼容)');
if (fs.existsSync(PLAYWRIGHT_CLI_BIN)) {
if (fs.existsSync(PLAYWRIGHT_CLI_LINK)) {
log(` ✅ 软链已存在: ${PLAYWRIGHT_CLI_LINK}`);
} else {
try {
fs.symlinkSync(PLAYWRIGHT_CLI_BIN, PLAYWRIGHT_CLI_LINK);
log(` ✅ 软链已建`);
} catch (e) {
log(` ⚠️ 软链失败: ${e.message}`);
}
// ==================== 2.5. playwright bin 软链兜底 ====================
// 优先指向本地 AI-friendly wrapper(session 模式),找不到时 fallback 到 npm 标准 bin
log('②.5 检查 playwright bin 软链 /usr/local/bin/playwright');
const ensureSymlink = (target) => {
// 幂等:先尝试 unlink 旧软链/文件(无则忽略)
try { fs.unlinkSync(PLAYWRIGHT_LINK); } catch {}
try {
fs.symlinkSync(target, PLAYWRIGHT_LINK);
return true;
} catch (e) {
log(` ⚠️ 软链失败: ${e.message}`);
return false;
}
};
if (fs.existsSync(PLAYWRIGHT_AI_CLI)) {
if (ensureSymlink(PLAYWRIGHT_AI_CLI)) {
log(` ✅ 软链已建: ${PLAYWRIGHT_LINK} → ${PLAYWRIGHT_AI_CLI}`);
log(` (AI wrapper: playwright -s=X open URL / snapshot / click / fill / eval / close)`);
}
} else if (fs.existsSync(PLAYWRIGHT_BIN)) {
if (ensureSymlink(PLAYWRIGHT_BIN)) {
log(` ⚠️ AI wrapper 不存在, fallback 到 npm 标准 bin(无 session 模式)`);
log(` 缺: ${PLAYWRIGHT_AI_CLI}`);
}
} else {
log(` ⚠️ 找不到 ${PLAYWRIGHT_CLI_BIN}(e2e 技能可能不可用)`);
log(` ⚠️ 找不到 playwright bin(e2e 技能可能不可用)`);
}
// ==================== 4. Chrome 检测/安装 ====================
log('④ 检查 google-chrome');
// ==================== 3. Chrome 检测/安装 ====================
log('③ 检查 google-chrome');
const chromeVer = tryExec('google-chrome --version');
if (chromeVer) {
log(` ✅ ${chromeVer}`);
+34 -20
View File
@@ -1,8 +1,9 @@
#!/bin/bash
# init.sh - 容器初始化脚本(替代 SessionStart 的两个 hook)
# 职责(全部幂等,可重复执行):
# 1. 把 dacli 可执行入口放到 /usr/local/bin/dacli(native 比 jar 新就软链 native,否则写 jar wrapper)
# 2. 保证 @playwright/cli + 软链 + Chrome 已就绪
# 1. 把 dacli 可执行入口放到 /usr/local/bin/dacli(TS 版 wrapper)
# 2. 保证 playwright Node.js 库(npm `playwright`)已安装 + bin 软链
# 3. 保证 google-chrome 已就绪(playwright install chrome 兜底)
#
# 触发:Dockerfile CMD 链式调用,容器首次启动时执行一次
# 输出:每步一行状态(容器 stdout,docker logs 可看)
@@ -10,14 +11,20 @@
# 设计:
# - 不阻塞 JNPF 启动:网络操作(npm install / playwright install)失败用 || true 兜底
# - 不删任何文件,幂等追加 alias(先 sed 清掉旧的同名行)
#
# v16 变更(2026-06-15):
# - 移除 @playwright/cli + 软链步骤(彻底废弃 @playwright/cli 包)
# - 统一用 playwright Node.js 库(npm `playwright`)的 bin
# - AI/skill 引用:`playwright-cli` → `playwright`(保持 -s=dacli session 共享模式)
set -u # 不用 -e:单步失败要继续后续步骤
CCWORKDIR="/home/ubuntu/ccWorkDir"
BASHRC="$HOME/.bashrc"
DACLI_SRC="$CCWORKDIR/dacli/src/cli.ts"
PLAYWRIGHT_CLI_BIN="/usr/lib/node_modules/@playwright/cli/playwright-cli.js"
PLAYWRIGHT_CLI_LINK="/usr/local/bin/playwright-cli"
PLAYWRIGHT_LIB_DIR="/usr/lib/node_modules/playwright"
PLAYWRIGHT_BIN="$PLAYWRIGHT_LIB_DIR/cli.js"
PLAYWRIGHT_LINK="/usr/local/bin/playwright"
log() { echo "[init.sh] $*"; }
@@ -42,30 +49,37 @@ else
fi
log " ✅ $(command -v dacli 2>/dev/null || echo '(未在 PATH 中)')"
# ============ 2. @playwright/cli 检测/安装 ============
log "② 检查 @playwright/cli"
if [ -f "$PLAYWRIGHT_CLI_BIN" ]; then
log " ✅ 已存在: $PLAYWRIGHT_CLI_BIN"
# ============ 2. playwright Node.js 库 检测/安装 ============
log "② 检查 playwright Node.js 库 (npm \`playwright\`)"
if [ -f "$PLAYWRIGHT_BIN" ]; then
log " ✅ 已存在: $PLAYWRIGHT_BIN"
else
log " ⏳ 安装 @playwright/cli ..."
npm uninstall -g playwright-cli >/dev/null 2>&1 || true
npm install -g @playwright/cli >/dev/null 2>&1 \
log " ⏳ 安装 playwright Node.js 库 ..."
npm install -g playwright >/dev/null 2>&1 \
&& log " ✅ 安装完成" \
|| log " ⚠️ 安装失败(继续,后续步骤不阻塞)"
fi
# ============ 3. playwright-cli 软链(让命令在 PATH 中可用) ============
log "③ 检查 playwright-cli 软链"
if [ -L "$PLAYWRIGHT_CLI_LINK" ] && [ -e "$PLAYWRIGHT_CLI_LINK" ]; then
log " ✅ 软链已存在: $PLAYWRIGHT_CLI_LINK"
# ============ 2.5. playwright bin 软链兜底 ============
# 优先指向本地 AI-friendly wrapper(session 模式),找不到时 fallback 到 npm 标准 bin
PLAYWRIGHT_AI_CLI="$CCWORKDIR/.claude/hooks/playwright-ai-cli.js"
log "②.5 检查 playwright bin 软链 /usr/local/bin/playwright"
if [ -f "$PLAYWRIGHT_AI_CLI" ]; then
ln -sf "$PLAYWRIGHT_AI_CLI" "$PLAYWRIGHT_LINK" 2>/dev/null \
&& log " ✅ 软链已建: $PLAYWRIGHT_LINK → $PLAYWRIGHT_AI_CLI" \
&& log " (AI wrapper: playwright -s=X open URL / snapshot / click / fill / eval / close)" \
|| log " ⚠️ 软链失败"
elif [ -f "$PLAYWRIGHT_BIN" ]; then
ln -sf "$PLAYWRIGHT_BIN" "$PLAYWRIGHT_LINK" 2>/dev/null \
&& log " ⚠️ AI wrapper 不存在, fallback 到 npm 标准 bin(无 session 模式)" \
&& log " 缺: $PLAYWRIGHT_AI_CLI" \
|| log " ⚠️ 软链失败"
else
ln -sf "$PLAYWRIGHT_CLI_BIN" "$PLAYWRIGHT_CLI_LINK" 2>/dev/null \
&& log " ✅ 软链已建" \
|| log " ⚠️ 软链失败(继续)"
log " ⚠️ 找不到 playwright bin(e2e 技能可能不可用)"
fi
# ============ 4. Chrome 检测/安装 ============
log "④ 检查 google-chrome"
# ============ 3. Chrome 检测/安装 ============
log "③ 检查 google-chrome"
if command -v google-chrome >/dev/null 2>&1; then
VER=$(google-chrome --version 2>/dev/null | awk '{print $3}')
log " ✅ chrome $VER"
+37
View File
@@ -0,0 +1,37 @@
#!/usr/bin/env node
/**
* playwright-ai-cli.js — AI 友好的 playwright CLI 包装(替代 @playwright/cli)
*
* 背景:v16 2026-06-15 迁移到 playwright Node.js 包。标准 `playwright` CLI
* (`/usr/lib/node_modules/playwright/cli.js` → `playwright/lib/program`)
* 只支持 test/codegen/screenshot 等一次性命令,不支持 session 模式
* (`playwright -s=name open/snapshot/click/fill/eval/close`)。
*
* session 模式来自 `playwright-core/lib/tools/cli-client/program`,
* 正是 @playwright/cli 用的入口(playwright-core 是 playwright 包的子模块)。
*
* 做法:本文件 5 行复刻 @playwright/cli 的逻辑,直接 require playwright-core 的
* cli-client program。安装位置 `/usr/lib/node_modules/playwright/ai-cli.js`,
* 由 init.js 软链到 /usr/local/bin/playwright,覆盖 npm 的标准 bin。
*
* 用法不变:
* playwright --version
* playwright -s=dacli open URL
* playwright -s=dacli snapshot
* playwright -s=dacli click e10
* playwright -s=dacli fill e21 "admin"
* playwright -s=dacli eval "() => document.title"
* playwright -s=dacli close
*
* 若需要标准 test/codegen/screenshot:
* npx playwright test
* npx playwright codegen URL
* node /usr/lib/node_modules/playwright/cli.js <args> # 直调标准 bin
*/
// 用绝对路径避免 Node 找不到全局模块(require 从 hooks 目录找 .claude/hooks/node_modules)
const path = require('path');
const programModule = require('/usr/lib/node_modules/playwright/node_modules/playwright-core/lib/tools/cli-client/program.js');
const playwrightPkg = require('/usr/lib/node_modules/playwright/package.json');
programModule.program({ embedderVersion: playwrightPkg.version });
+4 -4
View File
@@ -9,7 +9,7 @@ description: "api-test"
API 测试使用 **curl + jq** 调 JNPF 后端,**dacli** 提供登录态和业务命令封装。
**注意**:UI 自动化测试请使用 `ssw-e2e-test` 技能(基于原生 `playwright-cli`)。
**注意**:UI 自动化测试请使用 `ssw-e2e-test` 技能(基于原生 `playwright` Node.js 版 CLI)。
---
@@ -157,9 +157,9 @@ fi
## 与 UI 测试配合
```bash
# 1. UI 自动化新增(playwright-cli 直接调,详见 ssw-e2e-test)
playwright-cli -s=dacli open http://nginx/
playwright-cli -s=dacli eval "() => document.title"
# 1. UI 自动化新增(playwright 直接调,详见 ssw-e2e-test)
playwright -s=dacli open http://nginx/
playwright -s=dacli eval "() => document.title"
# 2. API 验证数据
curl -s "http://127.0.0.1:30000/api/visualdev/Base/$ID" \
+30 -28
View File
@@ -5,9 +5,11 @@ description: "ssw-e2e-test"
# SSW E2E Testing
E2E testing toolkit for jnpf low-code platform using **playwright-cli** (直接调,不再走 `dacli e2e` 包装)。
E2E testing toolkit for jnpf low-code platform using **playwright** Node.js 版 CLI(直接调,不再走 `dacli e2e` 包装)。
> 📦 **2026-06-05 变更**:dacli 不再包装 playwright-cli(移除 `dacli e2e`)。**直接用 `playwright-cli -s=dacli ...`**,session 共享 `-s=dacli` 名字。
> 📦 **2026-06-05 变更**:dacli 不再包装 playwright(移除 `dacli e2e`)。**直接用 `playwright -s=dacli ...`**,session 共享 `-s=dacli` 名字。
>
> 📦 **2026-06-15 变更**:从 `@playwright/cli` 包迁移到 `playwright` Node.js 包(同一 `playwright-core` CLI program,命令完全兼容,session 模式 `playwright -s=X ...` 不变)。
---
@@ -19,11 +21,11 @@ E2E testing toolkit for jnpf low-code platform using **playwright-cli** (直接
# 1. 检测 Node.js
node --version 2>/dev/null || echo "Node.js 未安装,请访问 https://nodejs.org/ 下载"
# 2. 检测 playwright-cli
playwright-cli --version 2>/dev/null || npm install -g @playwright/cli
# 2. 检测 playwright (Node.js 版)
playwright --version 2>/dev/null || npm install -g playwright
# 3. 检测 Chromium 浏览器
playwright-cli install chrome
playwright install chrome
# 4. 检测中文字体(容器内中文 label 显示为方框□□□□,盲点 36)
fc-list :lang=zh 2>/dev/null | grep -q "Noto Sans CJK" || apt-get install -y fonts-noto-cjk
@@ -37,7 +39,7 @@ export PLAYWRIGHT_BROWSERS_PATH=/home/ubuntu/.cache/ms-playwright
### 容器内 Playwright 替代方案(盲点 35)
> 背景:容器内 `playwright-cli -s=dacli open` 可能失败 `Cannot read properties of undefined (reading 'launch')`(npm playwright 缺 chromium 二进制)。改用 Python `playwright.sync_api`:
> 背景:容器内 `playwright -s=dacli open` 可能失败 `Cannot read properties of undefined (reading 'launch')`(npm playwright 缺 chromium 二进制)。改用 Python `playwright.sync_api`:
```python
from playwright.sync_api import sync_playwright
@@ -60,22 +62,22 @@ with sync_playwright() as p:
---
## playwright-cli 基本模式
## playwright 基本模式
**所有调用都用 `-s=dacli` 共享 session**(名字可自定义,但同一会话内必须一致):
```bash
# 打开页面
playwright-cli -s=dacli open "http://nginx/jnpf_app_tds/login"
playwright -s=dacli open "http://nginx/jnpf_app_tds/login"
# 跳转到指定URL
playwright-cli -s=dacli goto "http://nginx/jnpf_app_tds/"
playwright -s=dacli goto "http://nginx/jnpf_app_tds/"
# 关闭
playwright-cli -s=dacli close
playwright -s=dacli close
```
**注意**:如果 session 不存在或已关闭,先用 `playwright-cli -s=dacli open <url>` 启动。
**注意**:如果 session 不存在或已关闭,先用 `playwright -s=dacli open <url>` 启动。
---
@@ -84,7 +86,7 @@ playwright-cli -s=dacli close
### 第一阶段:界面探索与计划生成
**流程**:
1. 启动浏览器:`playwright-cli -s=dacli open <URL>`
1. 启动浏览器:`playwright -s=dacli open <URL>`
2. 处理登录(如需)
3. 目标地址校验
4. 界面探索(表单/按钮/表格/弹窗/下拉)
@@ -145,11 +147,11 @@ playwright-cli -s=dacli close
"name": "用例名称",
"steps": [
{
"cmd": "playwright-cli -s=dacli screenshot artifacts/e2e/runs/{runId}/screenshots/TC001-01-login.png",
"cmd": "playwright -s=dacli screenshot artifacts/e2e/runs/{runId}/screenshots/TC001-01-login.png",
"desc": "截图登录页"
},
{
"cmd": "playwright-cli -s=dacli fill #form_item_account admin",
"cmd": "playwright -s=dacli fill #form_item_account admin",
"desc": "填写账号"
}
],
@@ -166,7 +168,7 @@ playwright-cli -s=dacli close
```markdown
# E2E 执行报告
**计划路径:** `docs/playwright-cli-plans/<slug>.json`
**计划路径:** `docs/playwright-plans/<slug>.json`
**runId:** `<runId>`
**执行时间:** <时间>
@@ -189,7 +191,7 @@ artifacts/e2e/runs/<runId>/
## 失败与修复
### TC002 新增数据
**失败命令:** `playwright-cli -s=dacli click ".ant-btn-primary"`
**失败命令:** `playwright -s=dacli click ".ant-btn-primary"`
**错误:** `Error: Ref e50 not found`
**原因:** Modal 未完全渲染,ref 过期
**修复:** 重新 snapshot 获取新 ref
@@ -249,7 +251,7 @@ artifacts/e2e/runs/<runId>/
```
Task → Is it a jnpf platform test?
├─ Yes → Use ssw-e2e-test skill (本技能)
│ ├─ Login/menu → playwright-cli -s=dacli click "..."
│ ├─ Login/menu → playwright -s=dacli click "..."
│ ├─ 功能表单 (vxe-table) → JS patterns (Section 1-5)
│ ├─ 门户页面 → JS patterns (Section 6)
│ ├─ 大屏页面 → JS patterns (Section 7)
@@ -282,10 +284,10 @@ jnpf 菜单存在于 DOM 但可能不可见,Playwright 的 `force=True` 无效
})()
```
**playwright-cli 命令**:
**playwright 命令**:
```bash
# 用 eval 执行上面 JS(通过 jnpf-menu-item 匹配)
playwright-cli -s=dacli eval "() => {
playwright -s=dacli eval "() => {
const items = document.querySelectorAll('.jnpf-menu-item');
for (const item of items) {
if (item.innerText.includes('数据资产台账')) { item.click(); return 'clicked'; }
@@ -455,20 +457,20 @@ document.querySelector('.ant-select')?.click() // 失败!
const select = document.querySelector('.ant-modal .ant-select');
if (!select) return 'no select';
const box = select.getBoundingClientRect();
// 使用 playwright-cli 的 mouse.click 触发
// 使用 playwright 的 mouse.click 触发
return `click at ${box.x + box.width/2}, ${box.y + box.height/2}`;
})()
```
playwright-cli 执行时通过 `click` 配合坐标触发:
playwright 执行时通过 `click` 配合坐标触发:
```bash
# 取坐标
COORDS=$(playwright-cli -s=dacli eval "() => {
COORDS=$(playwright -s=dacli eval "() => {
const s = document.querySelector('.ant-modal .ant-select');
const b = s.getBoundingClientRect();
return [b.x + b.width/2, b.y + b.height/2];
}" | jq -c .)
playwright-cli -s=dacli mouse click $(echo $COORDS | jq -r '.[0]') $(echo $COORDS | jq -r '.[1]')
playwright -s=dacli mouse click $(echo $COORDS | jq -r '.[0]') $(echo $COORDS | jq -r '.[1]')
```
### Radio Button 处理
@@ -517,10 +519,10 @@ playwright-cli -s=dacli mouse click $(echo $COORDS | jq -r '.[0]') $(echo $COORD
```bash
# 1. 先创建数据
playwright-cli -s=dacli open "http://nginx/jnpf_app_tds/数据资产管理"
playwright -s=dacli open "http://nginx/jnpf_app_tds/数据资产管理"
# 2. 然后操作创建的数据
playwright-cli -s=dacli click ".vxe-body--row:first"
playwright -s=dacli click ".vxe-body--row:first"
# 3. 验证下游效果(使用 api-test 技能)
curl ...
@@ -607,11 +609,11 @@ curl ...
## 复杂场景 JS 脚本
当内置命令无法满足时,使用 playwright-cli 的 eval 配合 JS 脚本:
当内置命令无法满足时,使用 playwright 的 eval 配合 JS 脚本:
```bash
# 通过 stdin 传 JS
playwright-cli -s=dacli eval "$(cat /path/to/script.js)"
playwright -s=dacli eval "$(cat /path/to/script.js)"
```
### 完整 CRUD 示例脚本
@@ -730,7 +732,7 @@ dacli_web_session.py restore --session=/tmp/tdd.json \
```
### 2. 菜单点击无效
使用 playwright-cli `eval` 配合 JS `element.click()`,或 `playwright-cli -s=dacli click "selector"`
使用 playwright `eval` 配合 JS `element.click()`,或 `playwright -s=dacli click "selector"`
### 3. Modal 保存后不关闭
Modal 保持打开也可能是保存成功(检查行数是否增加)
+3 -3
View File
@@ -105,9 +105,9 @@ dacli tool logs --level=error --lines=100
# 2. 查 JNPF 错误码
grep -A 1 "MsgCode" /home/ubuntu/ccWorkDir/jnpf/后端/jnpf-common/jnpf-boot-common/jnpf-common-core/src/main/java/jnpf/constant/MsgCode.java
# 3. 浏览器 E2E 调试(playwright-cli 直接调)
playwright-cli -s=dacli eval "() => Array.from(document.querySelectorAll('.jnpf-menu-item')).map(e => e.innerText)"
playwright-cli -s=dacli console
# 3. 浏览器 E2E 调试(playwright 直接调)
playwright -s=dacli eval "() => Array.from(document.querySelectorAll('.jnpf-menu-item')).map(e => e.innerText)"
playwright -s=dacli console
# 4. 直接调用 API(curl + jq)
TOKEN=$(jq -r .token $ccWorkDir/.dacli-token/token.json)