Files
crawler-plugin/admin-frontend-vue/tests/load-failure-visibility.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

179 lines
8.9 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:模板内失败态只有 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), [], '补齐形态必须判成过,否则上面那条"名单外点名"没有区分力')
})