// 任务终态等待骨架的行为契约。跑法:npm test(node --test tests/*.test.ts) import { test } from 'node:test' import assert from 'node:assert/strict' import { DEFAULT_TRANSIENT_BUDGET, TERMINAL_TASK_STATUSES, isTerminalTaskStatus, waitForTaskTerminal, } from '../src/shared/utils/task-terminal.ts' /** * 只替 IO 边界(取数/睡眠/ disposed),循环本体真跑。 * sleep 里把 disposed 置上,避免非终态分支把用例吊死;keepPolling 让状态序列能走完。 */ function harness(overrides: any = {}) { const state: any = { disposed: false, statuses: [] as string[], errors: [] as Error[], sleeps: [] as number[], keepPolling: false, ...overrides, } const base: any = { taskId: 7, isDisposed: () => state.disposed, pollStatus: async () => { if (state.errors.length) throw state.errors.shift() return state.statuses.length > 1 ? state.statuses.shift() : state.statuses[0] ?? '' }, intervalMs: () => 1000, isTransient: (error: any) => /502|503|504|无法连接到服务|bad gateway|gateway timeout|network error|timeout/i.test( String(error?.message ?? error), ), sleep: async (ms: number) => { state.sleeps.push(ms) if (!state.keepPolling) state.disposed = true }, } return { state, base } } test('COMPLETED 是终态:窄集合那三页以前会空转到预算耗尽', async () => { const { base, state } = harness({ keepPolling: true }) state.statuses = ['RUNNING', 'COMPLETED'] assert.equal(await waitForTaskTerminal(base), 'COMPLETED') assert.equal(state.statuses.length, 1, 'COMPLETED 命中后不该继续把队列取空') }) test('SUCCESS 与 FAILED 同样立即终止', async () => { for (const status of ['SUCCESS', 'FAILED']) { const { base } = harness() base.pollStatus = async () => status assert.equal(await waitForTaskTerminal(base), status) } }) test('非终态继续等,并且每轮按页面给的间隔睡一次', async () => { const { base, state } = harness({ keepPolling: true }) state.statuses = ['RUNNING', 'PENDING', 'QUEUED', 'SUCCESS'] assert.equal(await waitForTaskTerminal(base), 'SUCCESS') assert.equal(state.sleeps.length, 3, '前三轮非终态各睡一次,第四轮命中即返回') assert.ok(state.sleeps.every((ms) => ms === 1000), 'sleep 用的是 intervalMs 的值') }) test('disposed 优先于一切判定', async () => { const { base, state } = harness() state.disposed = true state.statuses = ['SUCCESS'] assert.equal(await waitForTaskTerminal(base), 'STOPPED') }) test('瞬断计预算、恢复后清零、耗尽时抛错', async () => { const transient = () => new Error('502 Bad Gateway') const recovered = harness({ keepPolling: true }) const attempts: number[][] = [] recovered.base.onTransient = (attempt: number, budget: number) => attempts.push([attempt, budget]) recovered.state.errors = [transient(), transient()] recovered.state.statuses = ['RUNNING', 'SUCCESS'] assert.equal(await waitForTaskTerminal(recovered.base), 'SUCCESS') assert.deepEqual(attempts, [[1, DEFAULT_TRANSIENT_BUDGET], [2, DEFAULT_TRANSIENT_BUDGET]]) const exhausted = harness({ keepPolling: true }) exhausted.state.statuses = ['RUNNING'] exhausted.state.errors = Array.from({ length: DEFAULT_TRANSIENT_BUDGET }, transient) await assert.rejects(() => waitForTaskTerminal(exhausted.base), /等待服务恢复超时/) }) test('非瞬断异常直接上抛,不被骨架吞掉', async () => { const { base, state } = harness({ keepPolling: true }) state.errors = [new Error('任务不存在')] state.statuses = ['RUNNING'] await assert.rejects(() => waitForTaskTerminal(base), /任务不存在/) }) test('页专属终态(DELETED)必须显式传 terminal 才生效', async () => { const { base } = harness({ keepPolling: true }) base.pollStatus = async () => 'DELETED' // 默认集合里没有 DELETED ⇒ 巡店删除页必须自己把它列进 terminal,否则会永远等下去 const widened = await waitForTaskTerminal({ ...base, terminal: [...TERMINAL_TASK_STATUSES, 'DELETED'], }) assert.equal(widened, 'DELETED') }) test('isTerminalTaskStatus 与集合口径一致', () => { assert.equal(isTerminalTaskStatus('completed'), true, '大小写不敏感') assert.equal(isTerminalTaskStatus(' RUNNING '), false) assert.equal(isTerminalTaskStatus(undefined), false, '空状态不能算终态') assert.deepEqual([...TERMINAL_TASK_STATUSES].sort(), ['COMPLETED', 'FAILED', 'SUCCESS']) })