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 例。
179 lines
8.9 KiB
TypeScript
179 lines
8.9 KiB
TypeScript
/**
|
||
* 失败态可见 + 重试真能跑(四面9分口径 · 后管「交互 6.0:模板内失败态只有 4/24 页、重试按钮 2」)。
|
||
*
|
||
* 一条列表页的硬规矩(本仓界面铁律):**撤入口/重试入口必须同时是一条真能办成事的出口**。
|
||
* 所以这里不数「有没有红色文案」,而是逐页判三件事:
|
||
* ① 请求失败的 catch 真的把原因写进一个失败 ref(`<ref>.value =` 落在 catch 窗口里);
|
||
* ② 那个 ref 被模板 `v-if` 出来(不是一闪而过的 toast);
|
||
* ③ 页面上有一个重试入口,且它绑的函数在同一个文件里真的定义着(`@retry="load"` 指向不存在的
|
||
* 函数、或者只有「知道了」这种清掉红条的假出口,都算没过)。
|
||
*
|
||
* 名单(只许减):确实不该有重试按钮的页登记理由——登录页的出口是「再按一次登录」。
|
||
*/
|
||
import test from 'node:test'
|
||
import assert from 'node:assert/strict'
|
||
import { readdirSync } from 'node:fs'
|
||
import { readSource } from './helpers.ts'
|
||
import {
|
||
LOAD_FAILURE_RETRY_LABEL,
|
||
failureDetail,
|
||
loadFailureMessage,
|
||
scopeRefusalNote,
|
||
} from '../src/components/load-failure-model.ts'
|
||
|
||
/** 分母硬钉:2026-10-10 实测「有 *Loading = ref(false) 且 onMounted 取数」的页面 23 个。 */
|
||
const UNIVERSE_FLOOR = 20
|
||
/** 例外名单只许减:本轮只有登录页不进这条口径。 */
|
||
const LEDGER_CAP = 1
|
||
|
||
const LEDGER: Array<{ file: string; reason: string }> = [
|
||
{
|
||
file: 'src/pages/login/LoginPage.vue',
|
||
reason: '登录不是取数页:失败原因已由 errorMessage 的 role="alert" 说出,'
|
||
+ '重试入口就是那张表单上的「登录」按钮本身,再加一个重试按钮是重复入口',
|
||
},
|
||
]
|
||
|
||
function pageFiles(): string[] {
|
||
const out: string[] = []
|
||
for (const domain of readdirSync('src/pages')) {
|
||
for (const name of readdirSync(`src/pages/${domain}`)) {
|
||
if (name.endsWith('.vue')) out.push(`src/pages/${domain}/${name}`)
|
||
}
|
||
}
|
||
return out.sort()
|
||
}
|
||
|
||
function templateOf(src: string): string {
|
||
const at = src.indexOf('<template>')
|
||
return at < 0 ? '' : src.slice(at)
|
||
}
|
||
|
||
/** 页面的失败态判定:返回缺了哪几条(空数组 = 过)。 */
|
||
export function failureGaps(src: string): string[] {
|
||
const tmpl = templateOf(src)
|
||
const refs = [...src.matchAll(/const (\w*(?:[Ff]ailure|[Ee]rror)\w*) = ref\(/g)].map((m) => m[1])
|
||
const missing: string[] = []
|
||
const rendered = refs.filter((r) => new RegExp(`v-if="[^"]*\\b${r}\\b`).test(tmpl))
|
||
const writtenInCatch = refs.filter((r) => new RegExp(`catch[\\s\\S]{0,320}?${r}\\.value\\s*=`).test(src))
|
||
if (rendered.length === 0) missing.push(`失败原因没被模板 v-if 出来(refs=${refs.join('/')})`)
|
||
if (writtenInCatch.length === 0) missing.push('catch 里没有把失败原因写进任何失败 ref')
|
||
const candidates = [...tmpl.matchAll(/@retry="(\w+)"|@click="(\w+)"[^>]*>\s*重试/g)]
|
||
.map((m) => m[1] || m[2])
|
||
.filter((fn): fn is string => Boolean(fn))
|
||
const real = candidates.filter((fn) => new RegExp(`(?:function|const)\\s+${fn}\\s*[(=]`).test(src))
|
||
if (real.length === 0) missing.push(`没有真能重跑的入口(重试绑的函数须在页内定义;候选=${candidates.join('/')})`)
|
||
return missing
|
||
}
|
||
|
||
const UNIVERSE = pageFiles().filter((rel) => {
|
||
const src = readSource(rel)
|
||
return /\w*[Ll]oading = ref\(false\)/.test(src) && src.includes('onMounted(')
|
||
})
|
||
const ledgerHas = (rel: string) => LEDGER.some((e) => e.file === rel)
|
||
const offenders = UNIVERSE.filter((rel) => !ledgerHas(rel) && failureGaps(readSource(rel)).length > 0)
|
||
const staleLedger = LEDGER.filter((e) => !UNIVERSE.includes(e.file) || failureGaps(readSource(e.file)).length === 0)
|
||
|
||
test('分母硬钉:整棵 pages 都扫到,取数页数量不像被过滤掉', () => {
|
||
assert.ok(pageFiles().length >= 24, `只扫到 ${pageFiles().length} 个页面文件,扫描规则可能已失效`)
|
||
assert.ok(UNIVERSE.length >= UNIVERSE_FLOOR,
|
||
`首屏取数的页面只认出 ${UNIVERSE.length} 个(阈值 ${UNIVERSE_FLOOR}):判据漏了,"没有缺口"就读成了"没有请求"`)
|
||
})
|
||
|
||
test('每个取数页都要有可见失败态 + 真能重跑的入口(名单外点名,名单只许减)', () => {
|
||
assert.ok(LEDGER.length <= LEDGER_CAP, `例外名单从 ${LEDGER_CAP} 涨到 ${LEDGER.length}:这条口径只许减`)
|
||
assert.deepEqual(offenders, [], `失败态缺失的页面:\n${offenders
|
||
.map((f) => `${f}\n - ${failureGaps(readSource(f)).join('\n - ')}`).join('\n')}`)
|
||
assert.deepEqual(staleLedger.map((e) => e.file), [],
|
||
'名单里的页面已经补齐失败态(或已不是取数页),这条登记该删掉')
|
||
for (const entry of LEDGER) assert.ok(entry.reason.length >= 12, `${entry.file} 的例外理由没写清楚`)
|
||
})
|
||
|
||
test('失败文案模型:后端的中文原因进得来,英文原文进不来,取不到就只留兜底句', () => {
|
||
const forbidden403 = { response: { status: 403, data: { message: '无权操作该总数据' } } }
|
||
assert.equal(failureDetail(forbidden403), '无权操作该总数据')
|
||
assert.equal(loadFailureMessage(forbidden403, '删除失败'),
|
||
`删除失败:无权操作该总数据(${scopeRefusalNote('无权操作该总数据')})`)
|
||
// unwrap 抛出来的 Error(BusinessException 走 HTTP 200 + body)同样要能带出原因
|
||
assert.equal(loadFailureMessage(new Error('本公司已存在该数据'), '保存失败'), '保存失败:本公司已存在该数据')
|
||
// 后端把底层英文拼进 message:界面只留中文主干
|
||
assert.equal(loadFailureMessage(new Error('Internal Server Error'), '导出失败,请重试'), '导出失败,请重试')
|
||
assert.equal(loadFailureMessage(undefined, '数据加载失败'), '数据加载失败')
|
||
assert.equal(loadFailureMessage('网关超时', '数据加载失败'), '数据加载失败:网关超时')
|
||
// 兜底句里已经含原因时不重复拼一遍
|
||
assert.equal(loadFailureMessage(new Error('去重数据加载失败'), '去重数据加载失败'), '去重数据加载失败')
|
||
})
|
||
|
||
test('范围拒绝要给出路,不是只说"失败了"', () => {
|
||
assert.match(scopeRefusalNote('无权操作该分组数据'), /平台超级管理员/)
|
||
assert.match(scopeRefusalNote('缺少归属公司:请先在页面上方选择公司'), /平台超级管理员/)
|
||
assert.equal(scopeRefusalNote('本公司已存在该数据'), '', '普通业务校验不该被加成越权文案')
|
||
assert.equal(LOAD_FAILURE_RETRY_LABEL, '重试', '按钮字样必须是能办成事的「重试」,不是「知道了」')
|
||
})
|
||
|
||
test('重试入口的失败态组件本身不是占位:它把点击回抛给页面', () => {
|
||
const bar = readSource('src/components/LoadFailureBar.vue')
|
||
assert.match(bar, /\$emit\('retry'\)/, '按钮必须把动作交回页面的取数函数')
|
||
assert.match(bar, /defineEmits<\{\s*\(event: 'retry'\): void\s*\}>\(\)/)
|
||
assert.match(bar, /role="alert"/, '失败要对读屏与低视力用户可见')
|
||
})
|
||
|
||
test('非零对照:造一个"loading 结束但没有失败分支"的页面会被点名', () => {
|
||
const placeholder = `<script setup lang="ts">
|
||
import { onMounted, ref } from 'vue'
|
||
const loading = ref(false)
|
||
const rows = ref([])
|
||
async function load() {
|
||
loading.value = true
|
||
try { rows.value = await fetchRows() } catch (e) { showAdminFeedback('加载失败', 'error') }
|
||
finally { loading.value = false }
|
||
}
|
||
onMounted(load)
|
||
</script>
|
||
<template>
|
||
<div class="table-scroll"><table><tbody><tr><td>{{ rows.length }}</td></tr></tbody></table></div>
|
||
</template>
|
||
`
|
||
const gaps = failureGaps(placeholder)
|
||
assert.equal(gaps.length, 3, `缺口应当被逐条点名,实测=${JSON.stringify(gaps)}`)
|
||
assert.match(gaps.join(' '), /v-if/)
|
||
assert.match(gaps.join(' '), /重试/)
|
||
|
||
const dismissed = `<script setup lang="ts">
|
||
import { onMounted, ref } from 'vue'
|
||
const loading = ref(false)
|
||
const loadError = ref('')
|
||
async function load() {
|
||
loading.value = true
|
||
try { } catch (e) { loadError.value = '加载失败' } finally { loading.value = false }
|
||
}
|
||
function retry() { void load() }
|
||
onMounted(load)
|
||
</script>
|
||
<template>
|
||
<div v-if="loadError" class="msg err">
|
||
<span>{{ loadError }}</span>
|
||
<button type="button" @click="loadError = ''">知道了</button>
|
||
</div>
|
||
</template>
|
||
`
|
||
assert.equal(failureGaps(dismissed).length, 1, '只有「知道了」这种清条按钮 = 撤入口不是出口,必须被点名')
|
||
assert.match(failureGaps(dismissed)[0], /重试/)
|
||
|
||
const wired = `<script setup lang="ts">
|
||
import { onMounted, ref } from 'vue'
|
||
const loading = ref(false)
|
||
const loadFailure = ref('')
|
||
async function load() {
|
||
loading.value = true
|
||
try { } catch (e) { loadFailure.value = '加载失败' } finally { loading.value = false }
|
||
}
|
||
onMounted(load)
|
||
</script>
|
||
<template>
|
||
<LoadFailureBar v-if="loadFailure" :message="loadFailure" @retry="load" />
|
||
</template>
|
||
`
|
||
assert.deepEqual(failureGaps(wired), [], '补齐形态必须判成过,否则上面那条"名单外点名"没有区分力')
|
||
})
|