/** * F4-L1 页面设计器 e2e * * 闭环流程: * 1. 取标准层 schema(Node 侧 API,断言 X-Schema-Layer: standard) * 2. 保存 overlay(Node 侧 PUT) * 3. GET 断言 X-Schema-Layer: overlay,schema 内容已更新 * 4. 浏览器打开 /page/:templateId,断言 amis-host 渲染(overlay 版) * 5. 浏览器打开设计器 /editor.html?templateId=xxx(admin 可见) * 6. 设计器加载完成(designer-root 或 designer-loading→designer-root) * 7. 点击「还原标准版」按钮 * 8. GET 断言 X-Schema-Layer: standard(overlay 已删除) * 9. 测后保证清理(afterAll DELETE overlay 幂等) * * 测试用 00511ac1-ee64-4ecd-a550-22842ee5be72(会议纪要归档表单),不污染业务模板。 * 数据纪律:测后 DELETE overlay 还原;断言响应头变化。 */ import { expect, test, type Page } from '@playwright/test'; import http from 'node:http'; // ── 常量 ────────────────────────────────────────────────────────────────── const TEST_TEMPLATE_ID = '00511ac1-ee64-4ecd-a550-22842ee5be72'; // overlay 用于测试的轻量 schema(保留 type:page,改 title 以便断言) const OVERLAY_TITLE = 'E2E-Overlay-F4L1-测试定制标题'; const OVERLAY_SCHEMA = JSON.stringify({ type: 'page', title: OVERLAY_TITLE, body: [{ type: 'tpl', tpl: 'F4-L1 overlay 测试内容' }], }); // ── Node 侧 http 工具 ────────────────────────────────────────────────────── let _adminToken: string | undefined; async function adminToken(): Promise { if (_adminToken) return _adminToken; return new Promise((resolve, reject) => { const body = JSON.stringify({ account: 'admin', password: '111111' }); const req = http.request( { hostname: 'localhost', port: 8093, path: '/api/auth/login', method: 'POST', headers: { 'Content-Type': 'application/json', 'Content-Length': Buffer.byteLength(body) }, }, (res) => { let d = ''; res.on('data', (c) => (d += c)); res.on('end', () => { const p = JSON.parse(d) as { success: boolean; token: string }; if (!p.success) return reject(new Error('admin login failed')); _adminToken = p.token; resolve(p.token); }); }, ); req.on('error', reject); req.write(body); req.end(); }); } /** Node 侧 GET,返回 {body, headers, status} */ async function apiGet(path: string): Promise<{ body: string; headers: Record; status: number }> { const tok = await adminToken(); return new Promise((resolve, reject) => { const req = http.request( { hostname: 'localhost', port: 8093, path, method: 'GET', headers: { Authorization: `Bearer ${tok}`, 'Cache-Control': 'no-cache' }, }, (res) => { let d = ''; res.on('data', (c) => (d += c)); res.on('end', () => resolve({ body: d, headers: res.headers as Record, status: res.statusCode ?? 0 }), ); }, ); req.on('error', reject); req.end(); }); } /** Node 侧 PUT,返回解析后 JSON */ async function apiPut(path: string, body: string): Promise> { const tok = await adminToken(); return new Promise((resolve, reject) => { const req = http.request( { hostname: 'localhost', port: 8093, path, method: 'PUT', headers: { 'Content-Type': 'application/json', 'Content-Length': Buffer.byteLength(body), Authorization: `Bearer ${tok}`, }, }, (res) => { let d = ''; res.on('data', (c) => (d += c)); res.on('end', () => { try { resolve(JSON.parse(d)); } catch (e) { reject(e); } }); }, ); req.on('error', reject); req.write(body); req.end(); }); } /** Node 侧 DELETE,返回解析后 JSON */ async function apiDelete(path: string): Promise> { const tok = await adminToken(); return new Promise((resolve, reject) => { const req = http.request( { hostname: 'localhost', port: 8093, path, method: 'DELETE', headers: { Authorization: `Bearer ${tok}` }, }, (res) => { let d = ''; res.on('data', (c) => (d += c)); res.on('end', () => { try { resolve(JSON.parse(d)); } catch (e) { reject(e); } }); }, ); req.on('error', reject); req.end(); }); } // ── 种入 admin session(browser 侧) ──────────────────────────────────────── async function seedAdminAuth(page: Page) { const tok = await adminToken(); await page.addInitScript( ({ t }: { t: string }) => { localStorage.setItem('eip4_token', t); localStorage.setItem( 'eip4_profile', JSON.stringify({ userId: 'ADMIN', account: 'admin', name: '系统管理员', roles: [] }), ); }, { t: tok }, ); } // ── 测后清理 ─────────────────────────────────────────────────────────────── test.afterAll(async () => { // 幂等删除 overlay(保证还原标准版) await apiDelete(`/api/page/schema/${TEST_TEMPLATE_ID}/overlay`).catch(() => {}); }); // ============================================================================ // 测试套件 // ============================================================================ test.describe('F4-L1 设计器 overlay 协议', () => { test('1. 标准层 GET 返回 X-Schema-Layer: standard', async () => { // 先确保无 overlay(幂等 DELETE) await apiDelete(`/api/page/schema/${TEST_TEMPLATE_ID}/overlay`).catch(() => {}); const { headers, status } = await apiGet(`/api/page/schema/${TEST_TEMPLATE_ID}`); expect(status).toBe(200); expect(headers['x-schema-layer']).toBe('standard'); }); test('2. PUT overlay 保存成功,返回 status:0', async () => { const result = await apiPut( `/api/page/schema/${TEST_TEMPLATE_ID}/overlay`, OVERLAY_SCHEMA, ); expect(result['status']).toBe(0); const data = result['data'] as Record; expect(data['templateId']).toBe(TEST_TEMPLATE_ID); expect(typeof data['etag']).toBe('string'); expect((data['etag'] as string).length).toBe(64); // sha256 hex }); test('3. PUT overlay 后 GET 返回 X-Schema-Layer: overlay,title 已更新', async () => { const { body, headers, status } = await apiGet(`/api/page/schema/${TEST_TEMPLATE_ID}`); expect(status).toBe(200); expect(headers['x-schema-layer']).toBe('overlay'); const schema = JSON.parse(body) as Record; expect(schema['title']).toBe(OVERLAY_TITLE); }); test('4. ?layer=standard 强制取标准层,X-Schema-Layer: standard', async () => { const { headers, status } = await apiGet( `/api/page/schema/${TEST_TEMPLATE_ID}?layer=standard`, ); expect(status).toBe(200); expect(headers['x-schema-layer']).toBe('standard'); }); test('5. /page/:templateId 浏览器渲染 overlay 版(amis-host 可见)', async ({ page }) => { await seedAdminAuth(page); await page.goto(`/page/${TEST_TEMPLATE_ID}`); // 等待 amis 渲染宿主出现(最多 30s) await page.waitForSelector('[data-testid="amis-host"]', { timeout: 30000 }); // 无 schema 错误卡片 await expect(page.locator('[data-testid="schema-error-card"]')).toHaveCount(0); // 管理员可见「设计」按钮 await expect(page.locator('[data-testid="designer-open-btn"]')).toBeVisible(); }); test('6. 设计器页面加载(editor.html)—— designer-root 出现', async ({ page }) => { await seedAdminAuth(page); await page.goto(`/editor.html?templateId=${TEST_TEMPLATE_ID}`); // 等待设计器根节点(loading → root,最多 60s,amis-editor 首次加载较慢) await page.waitForSelector('[data-testid="designer-root"]', { timeout: 60000 }); // 顶部工具条可见 await expect(page.locator('[data-testid="designer-topbar"]')).toBeVisible(); // 保存/还原/预览按钮可见 await expect(page.locator('[data-testid="designer-btn-save"]')).toBeVisible(); await expect(page.locator('[data-testid="designer-btn-restore"]')).toBeVisible(); await expect(page.locator('[data-testid="designer-btn-preview"]')).toBeVisible(); // overlay badge 可见(当前是 overlay 状态) await expect(page.locator('[data-testid="designer-overlay-badge"]')).toBeVisible(); // 截图:设计器加载完成(画布编辑状态) await page.screenshot({ path: 'e2e/artifacts/f4-l1/01-designer-canvas.png', fullPage: false, }); }); test('7. 设计器「还原标准版」→ GET 返回 X-Schema-Layer: standard', async ({ page }) => { // 先确保 overlay 存在(前序 test 可能已删) await apiPut(`/api/page/schema/${TEST_TEMPLATE_ID}/overlay`, OVERLAY_SCHEMA); await seedAdminAuth(page); await page.goto(`/editor.html?templateId=${TEST_TEMPLATE_ID}`); await page.waitForSelector('[data-testid="designer-root"]', { timeout: 60000 }); // 等还原按钮可交互(amis-editor 完全初始化后才 enabled) await page.waitForSelector('[data-testid="designer-btn-restore"]:not([disabled])', { timeout: 30000 }); // 点击还原标准版 await page.click('[data-testid="designer-btn-restore"]'); // 等待成功 Toast await page.waitForSelector('[data-testid="designer-toast-success"]', { timeout: 30000 }); // 截图:还原成功提示 await page.screenshot({ path: 'e2e/artifacts/f4-l1/02-designer-restore-toast.png', fullPage: false, }); // Node 侧验证 X-Schema-Layer 回到 standard const { headers } = await apiGet(`/api/page/schema/${TEST_TEMPLATE_ID}`); expect(headers['x-schema-layer']).toBe('standard'); }); test('8. 还原后 /page/:templateId 渲染标准版(无 overlay)', async ({ page }) => { await seedAdminAuth(page); await page.goto(`/page/${TEST_TEMPLATE_ID}`); await page.waitForSelector('[data-testid="amis-host"]', { timeout: 30000 }); await expect(page.locator('[data-testid="schema-error-card"]')).toHaveCount(0); // 截图:渲染标准版效果 await page.screenshot({ path: 'e2e/artifacts/f4-l1/03-render-standard-after-restore.png', fullPage: false, }); }); }); test.describe('F4-L1 设计器「保存」按钮流程', () => { test('9. 设计器点击「保存」→ overlay 更新 → Toast 成功', async ({ page }) => { // 先确保有 overlay(PUT 一个初始版本) await apiPut(`/api/page/schema/${TEST_TEMPLATE_ID}/overlay`, OVERLAY_SCHEMA); await seedAdminAuth(page); await page.goto(`/editor.html?templateId=${TEST_TEMPLATE_ID}`); await page.waitForSelector('[data-testid="designer-root"]', { timeout: 60000 }); // 点击保存(当前 schema 即 currentSchemaRef 的值) await page.click('[data-testid="designer-btn-save"]'); await page.waitForSelector('[data-testid="designer-toast-success"]', { timeout: 15000 }); // 截图:保存提示 await page.screenshot({ path: 'e2e/artifacts/f4-l1/04-designer-save-toast.png', fullPage: false, }); // 验证 overlay 仍然存在 const { headers } = await apiGet(`/api/page/schema/${TEST_TEMPLATE_ID}`); expect(headers['x-schema-layer']).toBe('overlay'); // 清理 await apiDelete(`/api/page/schema/${TEST_TEMPLATE_ID}/overlay`).catch(() => {}); }); });