import { test } from 'node:test' import assert from 'node:assert/strict' /** * 运动员「彻底删除」的前端契约:方法 / 路径 + `?purge=1`,以及失败时服务端那句话的传递。 * * 服务端的原文(例如 404「运动员不存在」)一旦被换成「操作失败」现场就只能靠猜; * 而 404 又是「人员已不在」的真实回答,绝不能降级成示例数据假装删掉了。 */ interface Captured { url?: string method?: string headers?: Record } function jsonResponse(body: unknown, status = 200): Response { return new Response(JSON.stringify(body), { status, headers: { 'Content-Type': 'application/json' }, }) } let reply: () => Response = () => jsonResponse({ ok: true, data: null }) let lastRequest: Captured = {} // 必须在导入被测模块之前装好:ApiClient 在构造时就把当时的 fetch 绑进实例, // 之后再替换 globalThis.fetch 对它无效。所以这里装一个固定函数,每个用例只换回复。 globalThis.fetch = (async (input: unknown, init?: RequestInit) => { lastRequest = { url: String(input), method: init?.method ?? 'GET', headers: (init?.headers ?? {}) as Record, } return reply() }) as typeof fetch function respondWith(response: () => Response): void { lastRequest = {} reply = response } const { ApiError, adminApi, mockMode, SAMPLE_DATA_BLOCKED } = await import('../api/client') const { baseDataApi, baseDataFallback } = await import('../components/baseData/baseDataApi') test('彻底删除走 DELETE /api/athletes/{id}?purge=1', async () => { respondWith(() => jsonResponse({ ok: true, data: null })) await adminApi.purgeAthlete(7) assert.equal(lastRequest.url, '/api/athletes/7?purge=1') assert.equal(lastRequest.method, 'DELETE') }) // 字段名与服务端 athletePurge 一致;页面提示语要靠它说清「删了什么、重算了哪些小项」。 test('成功响应带统计时,客户端拿到删除规模与重算小项', async () => { respondWith(() => jsonResponse({ ok: true, data: { deletedEntries: 1, deletedResults: 1, deletedLedger: 2, deletedBreaks: 0, recomputedEvents: [1] }, }), ) const result = await adminApi.purgeAthlete(7) assert.deepEqual(result, { deletedEntries: 1, deletedResults: 1, deletedLedger: 2, deletedBreaks: 0, recomputedEvents: [1], }) }) // 删除在服务端已经提交、不可回滚:统计缺失时也只能按 0 报,不能冒出 undefined 或报成失败。 test('服务端没带统计时按 0 / 空数组兜底', async () => { respondWith(() => jsonResponse({ ok: true, data: null })) const result = await adminApi.purgeAthlete(7) assert.deepEqual(result, { deletedEntries: 0, deletedResults: 0, deletedLedger: 0, deletedBreaks: 0, recomputedEvents: [], }) }) // 服务端中间件要求已登录的写请求带 X-CSRF-Token,漏掉就是 403,删不掉还看不出原因。 test('彻底删除带上 CSRF 双提交 Cookie 的请求头', async () => { respondWith(() => jsonResponse({ ok: true, data: null })) const globalWithDocument = globalThis as { document?: unknown } globalWithDocument.document = { cookie: 'csrf_token=token-123' } try { await adminApi.purgeAthlete(1) } finally { delete globalWithDocument.document } assert.equal(lastRequest.headers?.['X-CSRF-Token'], 'token-123') }) test('失败时不吞错误:服务端那句原文原样带出', async () => { respondWith(() => jsonResponse({ ok: false, error: { code: 'INTERNAL', message: '服务端异常' } }, 500), ) await assert.rejects( () => adminApi.purgeAthlete(7), (error: unknown) => { assert.ok(error instanceof ApiError) assert.equal(error.status, 500) assert.equal(error.code, 'INTERNAL') assert.equal(error.message, '服务端异常') return true }, ) }) // 页面调用的是 baseDataApi 这一层:权限 / 服务端错误都是真实回答,不能降级成示例数据假装删掉了。 test('基础数据层把服务端错误原样抛给页面,不降级成示例数据', async () => { baseDataFallback.value = false respondWith(() => jsonResponse({ ok: false, error: { code: 'FORBIDDEN', message: '需要管理员权限' } }, 403), ) await assert.rejects(() => baseDataApi.athletes.purge(7), (error: Error) => error.message.includes('需要管理员权限'), ) assert.equal(baseDataFallback.value, false, '不应切到示例数据') }) // 404 是「人员已经被别人删掉」这种真实回答,不是「接口未实现」: // 一旦降级到示例数据,页面会把「根本没删掉」提示成「已彻底删除」。 test('purge 收到 404 时不降级,错误原样抛给页面', async () => { baseDataFallback.value = false respondWith(() => jsonResponse({ ok: false, error: { code: 'VALIDATION_FAILED', message: '运动员不存在' } }, 404), ) await assert.rejects( () => baseDataApi.athletes.purge(7), (error: unknown) => { assert.ok(error instanceof ApiError) assert.equal(error.status, 404) assert.equal(error.message, '运动员不存在') return true }, ) assert.equal(baseDataFallback.value, false, '不应切到示例数据') }) // 对照组:同组的软删除 remove 行为不变,404 仍按「接口未实现」降级到示例数据。 // 示例数据里 id=1001 存在,能删掉就说明确实走了 mock 分支,而不是把 404 抛了出来。 test('remove 的 404 仍降级到示例数据(既有行为未受影响)', async () => { baseDataFallback.value = false respondWith(() => jsonResponse({ ok: false, error: { code: 'VALIDATION_FAILED', message: '运动员不存在' } }, 404), ) await baseDataApi.athletes.remove(1001) assert.equal(baseDataFallback.value, true) }) // 后端整体连不上时不再降级示例数据:内存里「删掉」会让操作员以为人真被删了, // 恢复连接后这些人又会全部回来。必须给出可识别的「未提交」结果(SAMPLE_DATA_BLOCKED)。 test('后端不可用时彻底删除被阻断:不降级示例数据、不返回假成功', async () => { baseDataFallback.value = false mockMode.value = false respondWith(() => { throw new TypeError('fetch failed') }) await assert.rejects( () => baseDataApi.athletes.purge(1002), (error: unknown) => { assert.ok(error instanceof ApiError) assert.equal(error.code, SAMPLE_DATA_BLOCKED) assert.match(error.message, /示例数据/) return true }, ) assert.equal(baseDataFallback.value, true, '写请求撞上后端不可达后,页面应切到示例数据标记') })