/** * 统一提示出口的收口台账(四面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) })