8776a9bf1e
- 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 例。
144 lines
7.3 KiB
TypeScript
144 lines
7.3 KiB
TypeScript
/**
|
||
* 统一提示出口的收口台账(四面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)
|
||
})
|