Files
crawler-plugin/frontend-vue/tests/task-progress-view-wiring.test.ts
T
huangzd1997 3d12689349 前端(任务卡进度条): 10 页接上实时进度,3 页没分母的显式写 null
后端已把心跳里的 current/total 透到 progress/light,但 TaskItemView.progress 是可空字段:
页面少写一行不会报错也不会红,界面上就是安静地没有进度条——11 类客户端任务里 7 类正是这样。

- 新增 src/shared/api/task-progress-live.ts:进度走独立通道,模块级缓存 + 60s 新鲜窗口
  为什么不并进任务对象:各页 {...prev.task, ...detail.task} 合并里有 5 处带「变更签名」守卫
  (rowsVersion|status|fileStatus|fileReady)。进度每轮都在动,而签名在「正在翻页、还没攒够一批
  回传」的时段不变——照那条路走,进度条会一路停在上一次回传的数字上,看着像卡死
- 写入点挂在 light 出口(progress-light.ts)而不是聚合层:4 个页面直接调 getModuleProgressLight
  不经过 getPollingProgressBatch,挂聚合层它们永远拿不到;命中缓存也要刷一遍读数,
  否则进度会在缓存窗口里被自己的新鲜判定踢掉、凭空消失
- toBatchItems 与 LightPollingItem 补三字段:这里的键集是逐字段挑的,少挑一个就把后端给的数丢掉
- 10 页接 liveProgress:解决风控、跟价、定时匹配、状态查询、提款、巡店删除、商品管理采集等
- Convert/Dedupe/Split 三页写死 progress: null 并说明原因:它们卡列的是完成记录、没有可数的分母。
  显式 null 与省略字段在代码里必须长得不一样,否则下一个人无法区分「没得画」和「忘了接」
- 新增 tests/task-progress-view-wiring.test.ts:适配器清单由文件系统给出、总数硬钉 16,
  判据同时认 `progress:` 与 ES6 简写 `progress,`(只认冒号把 BrandBrandTab 误报成缺口,
  而误报的尺子会被人当噪音绕过去);变异自证三处全 KILLED——抽掉跟价页的接线、
  摘掉批次白名单的 progressTotal、去掉分母塌 0 时的旧读数清理,还原后字节哈希一致
- tests/task-progress-polling.test.ts 的整份形状断言同步加三字段(它本来就该在我改白名单时红)
2026-10-10 21:00:01 +08:00

76 lines
3.9 KiB
TypeScript
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
import { test } from 'node:test'
import assert from 'node:assert/strict'
import { readFileSync, readdirSync } from 'node:fs'
import { join } from 'node:path'
/**
* 任务卡片的「进度条接线」普查。
*
* 为什么要它:TaskItemView.progress 是可空字段,页面少写一行不会报错、不会红,
* 界面上就是安静地没有进度条。11 个任务页各写一处,漏哪一处全靠这条出声。
*
* 分母不手抄:扫 src/pages/brand/components 下所有写了 `to*TaskView(...): TaskItemView`
* 适配器的页面,清单由文件系统给出;再把总数硬钉住——新增页面没接进度、或有人把
* 适配器改名躲开扫描,都在这条上出声(只比总数会被「内部搬家」绕过,所以逐个点名)。
*/
const COMPONENTS = join(import.meta.dirname, '..', 'src', 'pages', 'brand', 'components')
const ADAPTER_PATTERN = /function (to\w*TaskView)\(/
/**
* 判据只看「适配器返回的对象里出现了 progress 属性」,两种写法都认:
* `progress: {…}` 与 ES6 简写 `progress,`(BrandBrandTab 用后者,只认冒号会把它误报成缺口,
* 而误报的尺子很快会被人当噪音绕过去)。
*/
const PROGRESS_KEY = /^\s*(?:progress\s*:|progress\s*,)/m
function adaptersOf(file: string) {
const lines = readFileSync(join(COMPONENTS, file), 'utf8').split(/\r?\n/)
const found: { name: string; start: number; end: number }[] = []
for (let index = 0; index < lines.length; index += 1) {
const matched = ADAPTER_PATTERN.exec(lines[index])
if (!matched) continue
let end = index
while (end + 1 < lines.length && lines[end + 1] !== '}') end += 1
found.push({ name: matched[1], start: index, end })
}
return found
}
const pages = readdirSync(COMPONENTS).filter((name) => name.endsWith('.vue'))
const seen = pages.flatMap((file) => adaptersOf(file).map((a) => ({ file, ...a })))
test('被扫描的任务卡适配器数量必须硬钉(少扫或多扫都说明扫描面变了)', () => {
assert.equal(seen.length, 16, `扫到 ${seen.length} 个 to*TaskView 适配器:${seen.map((s) => `${s.file}#${s.name}`).join(', ')}`)
})
test('每个任务卡适配器都必须给出进度读数,或明确给出 null', () => {
const offenders = seen
.filter((entry) => {
const lines = readFileSync(join(COMPONENTS, entry.file), 'utf8').split(/\r?\n/)
const body = lines.slice(entry.start, entry.end + 1).join('\n')
return !PROGRESS_KEY.test(body)
})
.map((entry) => `${entry.file}#${entry.name}`)
assert.deepEqual(offenders, [], '这些任务页画不出进度条:' + offenders.join(', '))
})
test('实时进度通道的写入点只有一个,且在 light 出口上', () => {
const sharedDir = join(import.meta.dirname, '..', 'src', 'shared', 'api')
const callers = readdirSync(sharedDir)
.filter((name) => name.endsWith('.ts') && name !== 'task-progress-live.ts')
.filter((name) => readFileSync(join(sharedDir, name), 'utf8').includes('rememberLiveProgress('))
assert.deepEqual(callers, ['progress-light.ts'],
'rememberLiveProgress 的调用者必须是 light 出口一处;多处写会让刷新时机和过期判定分家:' + callers.join(', '))
})
test('light 白名单与后端 VO 的进度三字段同名同形', () => {
const light = readFileSync(join(import.meta.dirname, '..', 'src', 'shared', 'api', 'progress-light.ts'), 'utf8')
const polling = readFileSync(join(import.meta.dirname, '..', 'src', 'shared', 'api', 'task-progress-polling.ts'), 'utf8')
for (const field of ['progressCurrent', 'progressTotal', 'progressLabel']) {
assert.ok(light.includes(`${field}?:`), `progress-light.ts 的白名单缺 ${field}`)
// toBatchItems 的键集是逐字段挑的,少挑一个就把后端给的数丢掉
assert.ok(polling.includes(`${field}: item.${field} ?? null`), `task-progress-polling.ts 归一时丢了 ${field}`)
}
})