Files
crawler-plugin/admin-frontend-vue/tests/error-feedback-exit-ledger.test.ts
huangzd1997 8776a9bf1e 后管(四面9分批次): 裸提示 92→0、裸 confirm 24→0 且逐处 await、失败态可见并真能重试
- ElMessage.error 全收进 showAdminFeedback(例外清单 CAP=0,唯一保留的裸调用是出口本体);
  window.confirm 24 处全部改成 await 的 openAdminConfirm(逐处核过所在函数本就 async,
  不存在"点了确认不执行"的异步断层)。
- 新增 load-failure-model + LoadFailureBar:22/23 个取数页有失败态与真重试
  (只有"知道了"清条不算过),例外仅登录页。
- DedupeRegistryPage / DuplicateCheckPage 补 onUnmounted,并加全树定时器/监听配对判据。
- 去重页那处"能点但后端 403":读侧认 wholeCompany、写侧只认 groupIds/userIds 的不对称
  本轮没动后端(前端拿不到与写侧同集合的 groupIds,按它置灰会误伤同事名下真能改的行=静默删功能);
  先修更实在的一半——403 的中文原因此前整段丢失,现在走统一文案到界面。
- 验收:node --test 1,818 例 0 红、npx vue-tsc --noEmit rc=0;5 支新判据 26 例。
2026-10-09 23:09:37 +08:00

144 lines
7.3 KiB
TypeScript
Raw Permalink 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.
/**
* 统一提示出口的收口台账(四面9分口径 · 后管「复用 6.0」)。
*
* 评审实测:`showAdminFeedback` 只有 17 处调用,而裸 `ElMessage.error` **92 处**——同一件事
* (把后端或本地的错误文本弹给用户)有两种写法,新页面跟着抄哪一种全看运气,文案与时长也无从统一。
* 这一支把 92 处机械可换的全部换成 `showAdminFeedback(msg, 'error')`,然后把「还剩哪几处裸调用」
* 落成一张显式名单:
* ① 名单外的任何裸 `ElMessage.error(` 一律红(新增拦在提交前,而不是等下轮评审再数一遍);
* ② 名单里每一条都必须在文件里仍然成立(防止台账烂成没人删的历史账);
* ③ 名单本身只许减(BARE_SITE_LEDGER_CAP=0)。
*
* 判据不锚行号:锚的是「哪个文件里还有裸调用」与「出口调用行的形状」。
*/
import test from 'node:test'
import assert from 'node:assert/strict'
import { readdirSync, statSync } from 'node:fs'
import { join } from 'node:path'
import { occurrences, readSource } from './helpers.ts'
const EXIT_MODULE = 'src/components/admin-feedback-ui.ts'
/** 例外名单只许减:收口批次结束时是 0 处(出口实现自己那一处不算名单,另用例单独钉)。 */
const BARE_SITE_LEDGER_CAP = 0
/** 出口实现里那一处 `ElMessage.error(m)` 是这条出口的本体。 */
const EXIT_MODULE_CALLS = 1
/** 分母硬钉:2026-10-10 实测走统一出口的 error 行 ≥ 92(92 处收口 + 批次前已有的几处)。 */
const EXIT_ERROR_LINES_FLOOR = 92
/** 名单:不机械替换的裸调用,逐条给理由。新增一条 = 本用例红(超上限),且必须仍能对上实际代码。 */
const BARE_SITE_LEDGER: Array<{ file: string; reason: string }> = []
function blankComments(src: string): string {
return src
.replace(/\/\*[\s\S]*?\*\//g, (block) => block.replace(/[^\n]/g, ' '))
.replace(/^[ \t]*\/\/[^\n]*/gm, (line) => ' '.repeat(line.length))
}
/** 剥掉注释与字符串字面量的内容:字符串里的 "ElMessage.error(" 字样不能算调用点。 */
function stripNonCode(src: string): string {
const out: string[] = []
let i = 0
const n = src.length
while (i < n) {
const two = src.slice(i, i + 2)
if (two === '/*') {
const close = src.indexOf('*/', i + 2)
const end = close < 0 ? n : close + 2
for (let k = i; k < end; k++) out.push(src[k] === '\n' ? '\n' : ' ')
i = end; continue
}
if (two === '//') {
const nl = src.indexOf('\n', i + 2)
const end = nl < 0 ? n : nl
for (let k = i; k < end; k++) out.push(src[k] === '\n' ? '\n' : ' ')
i = end; continue
}
const q = src[i]
if (q === '"' || q === "'" || q === '`') {
let k = i + 1
out.push(' ')
while (k < n) {
if (src[k] === '\\') { out.push(' ', src[k + 1] === '\n' ? '\n' : ' '); k += 2; continue }
if (src[k] === q) { out.push(' '); k++; break }
out.push(src[k] === '\n' ? '\n' : ' ')
k++
}
i = k; continue
}
out.push(src[i]); i++
}
return out.join('')
}
/** 在一个源码文本里数裸 ElMessage.error(注释与字符串里的字样不算)。 */
export function bareErrorCount(src: string): number {
return occurrences(stripNonCode(src), 'ElMessage.error(')
}
/**
* 数「走统一出口的 error 行」:一行里同时出现 `showAdminFeedback(` 与 `, 'error')`。
* 用整行而不是 `showAdminFeedback\([^)]*, 'error'\)`——参数里带函数调用(`errorText(error, '…')`)时
* `[^)]*` 会在第一个右括号处收口,分母会凭空少一截,把"扫不到"读成"没有"。
*/
export function exitErrorLineCount(src: string): number {
return blankComments(src).split('\n')
.filter((line) => line.includes('showAdminFeedback(') && line.includes(", 'error')")).length
}
function sourceFiles(): string[] {
const out: string[] = []
const walk = (dir: string): void => {
for (const name of readdirSync(dir)) {
const abs = join(dir, name)
if (name.endsWith('.d.ts')) continue
if (statSync(abs).isDirectory()) walk(abs)
else if (name.endsWith('.vue') || name.endsWith('.ts')) out.push(abs.split(/[\\/]+/).join('/'))
}
}
walk('src')
return out
}
const FILES = sourceFiles()
/** 出口实现之外,全树仍然裸打 ElMessage.error 的文件。 */
const offenders = FILES.filter((rel) => rel !== EXIT_MODULE && bareErrorCount(readSource(rel)) > 0)
test('分母硬钉:扫描真的覆盖整棵 src,统一出口的 error 也确实被数到', () => {
// 2026-10-10 实测 src 下 212 个 .vue/.ts;掉一档说明 walk 或后缀判据坏了。
assert.ok(FILES.length >= 180, `只扫到 ${FILES.length} 个源文件,扫描规则可能已失效`)
const viaExit = FILES.reduce((sum, rel) => sum + exitErrorLineCount(readSource(rel)), 0)
assert.ok(viaExit >= EXIT_ERROR_LINES_FLOOR,
`走统一出口的 error 只有 ${viaExit} 处:92 处收口没落地,或被整体扫漏了("扫不到"不等于"没有")`)
})
test('出口实现里那一处 ElMessage.error 是出口本体,恰好一处', () => {
assert.equal(bareErrorCount(readSource(EXIT_MODULE)), EXIT_MODULE_CALLS,
'admin-feedback-ui.ts 是唯一允许裸 ElMessage.error 的地方,且只能有出口那 1 处')
})
test('名单外的裸 ElMessage.error 一律点名;名单只许减、每条必须仍然成立', () => {
assert.ok(BARE_SITE_LEDGER.length <= BARE_SITE_LEDGER_CAP,
`例外名单从 ${BARE_SITE_LEDGER_CAP} 涨到 ${BARE_SITE_LEDGER.length}:这条口径只许减`)
assert.deepEqual(offenders.slice().sort(), BARE_SITE_LEDGER.map((e) => e.file).sort(),
`裸调用文件与名单不等值。名单外新增=${offenders.filter((f) => !BARE_SITE_LEDGER.some((e) => e.file === f))},`
+ `名单里已消失(该删掉这条登记)=${BARE_SITE_LEDGER.filter((e) => !offenders.includes(e.file)).map((e) => e.file)}`)
// 登记的每一条都得真的还有裸调用:烂账(登记了但代码里已经没有了)同样算破口。
for (const entry of BARE_SITE_LEDGER) {
assert.ok(bareErrorCount(readSource(entry.file)) > 0, `${entry.file} 已无裸调用,这条登记该删`)
assert.ok(entry.reason.trim().length >= 8, `${entry.file} 的例外理由没写清楚`)
}
})
test('非零对照:扫描会抓到裸调用,也不会把统一出口误报成裸调用', () => {
const injected = "try { await x() } catch (e) { ElMessage.error('店铺列表加载失败') }\n"
assert.equal(bareErrorCount(injected), 1, '扫不出注入的裸调用 ⇒ 上面那条"名单外点名"是恒绿的')
assert.equal(exitErrorLineCount(injected), 0)
const migrated = "try { await x() } catch (e) { showAdminFeedback('店铺列表加载失败', 'error') }\n"
assert.equal(bareErrorCount(migrated), 0)
assert.equal(exitErrorLineCount(migrated), 1, '统一出口的 error 支必须被分母数到')
// 参数里再套一层函数调用时,分母仍然数得到(这条正是 `[^)]*` 写法会静默漏掉的那种)。
assert.equal(exitErrorLineCount("showAdminFeedback(errorText(error, '任务列表加载失败'), 'error')"), 1)
assert.equal(bareErrorCount('// ElMessage.error( 只是注释里的字样'), 0, '注释里的字样算进来会让本用例永远红')
assert.equal(bareErrorCount("const doc = 'ElMessage.error( 出现在字符串里'"), 0)
})