Files
crawler-plugin/admin-frontend-vue/tests/notification-bell-failure.test.ts
T
huangzd1997 f68d1afecf refactor(通知): 铃铛面板状态机从 SFC 拆成独立一层——是上一笔把两个组件顶到可读棘轮 800 行上限的账,不是新功能
上一笔(5d2a1c69 通知聚合)推 origin 时被四面闸门连拒两次,两次都不是回归:
第一次是负载把 score_ratchet 的 py_case 挤成负数超时(单跑那格 18 秒绿,带 capture_output 复跑 24 秒 rc=0,
管道阻塞这条已排除);第二次读数清楚——后管 10 格红、客户端 48 格红,红的都是我这笔造成的:
① 可读棘轮按对象点名:后管 NotificationBell.vue 700→877 是"新增超长文件",用户端 1318→1439 是"比基线更长";
② 后管还有一把 vitest 挂载尺子(tests/mount/**,npm test 那个 glob 不递归 ⇒ 上一笔我漏跑了),
   它 mock 的还是单层列表接口,两级改造后 2 条判红——这条是我上一轮汇报里说"后管全绿"的假话,先认。

拆法按尺子自己给的那条路("要么拆,要么逐条点名改基线并写清是谁的哪一笔"):放宽基线要人拍板,所以拆。
只搬 script,样式一行没动——搬模板会把 scoped 样式的后代选择器甩在父作用域外,那是会改画面的拆法。
新层是纯 TS + 一个 composable:后管 src/layout/notification-bell-panel.ts、用户端 src/shared/composables/useNotificationBellPanel.ts,
组件只留面板开合、fixed 定位、外部点击关闭、60s 轮询定时器;行数 后管 877→652、用户端 1439→1213(台账点名的基线是 1318)。

这一层是纯函数,于是判据从"源码里有没有那行字"升级成"喂数据看返回值":
新增 tests/pure/notification-bell-panel.test.ts 两支(后管 9 例 / 用户端 8 例,走 vitest——这层要解析 @ 别名与 vue,
进不了零依赖的 node --test,两面 vitest.config 的 include 因此多收一格,注释同步改掉)。
覆盖:红点按组数、组内没读完不许减组数、下钻三维(主体为空改 IS NULL 旗标)、日期倒挂交换、
聚合页缺字段时的回落、换天才挂日期头、级别兜底、水位只在首页有数据时推进。
变异自证 6 条全 KILLED(A1 组数提前掉/A2 下钻丢主体/A3 天天挂头/D1 组数提前掉/D2 丢 IS NULL 旗标/D3 日期不交换),
还原按注入前内存字节写回并比过(admin 13790 / desktop 13115)。

三处台账跟着实况走,没有一处是放宽:
① 用户端 catch 棘轮 perFile:组件 3→0、新记 useNotificationBellPanel.ts=2,silent 总数 84→83(尺子的注释要求降了就一起改小);
   blocks 仍 299(搬动不改分母)。
② 后管 source-pin 台账:notification-bell-failure.test.ts 的钉子从 SFC 复指到新层,
   readSource 读点数不变(中途加过一枚"组件确实在用这层"的钉子,实测会把台账读点数抬上去,
   而这条已由挂载用例在运行时证 ⇒ 撤掉,不往只许减的台账里添)。
③ 后管挂载用例 4→6 例(补"点聚合行只展开不标已读""红点按组数""下钻带主体")。

验证=后管 node --test 1819/1819、vitest 21/21(12 挂载 + 9 纯函数)、真浏览器 e2e 10/10、vue-tsc rc=0;
用户端 node --test 834/834、vitest 16/16(8 挂载 + 8 纯函数)、vue-tsc rc=0;
ops 侧 test_readability_ratchet 9/9 绿(这条是上一笔红的因,现已解)。
⚠ scripts/tests 整量此刻仍 1 格红,红的不是本笔:scripts/tests/test_无声台账放宽闸.py 于 10-13 09:56 被另一路会话
扩写进 RD2 三记反例(3f55f3b),而配套 app_client/scripts/gen_silent_ledger.py 的 --check 还只判总数轴(那份 10-12 23:12 起没动)
⇒ 逐文件那一条轴此刻必然判不到,本笔不动别人的尺子也不替别人抬基线。
2026-10-13 10:38:34 +08:00

114 lines
6.4 KiB
TypeScript
Raw 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分口径 §2 后管「0 组件挂载测试 / 错误静默」)。
*
* 前 4 支是**行为断言**:直接 import `src/layout/notification-bell-model.ts` 跑真函数,
* 提示出口是注入进去的假 sink——不挂载组件也测得到运行时行为。
* 第 5 支是**源码钉子**(readSource):钉的是「面板层那两处 catch 接的是这条出口」这个形状,
* (10-13 起 catch 在 notification-bell-panel.ts,同支还钉住组件确实 import 了这层。)
* 不是运行时行为;运行时那一面由 `tests/mount/notification-bell-failure.mount.test.ts`
* (`npm run test:mount`,vitest + @vue/test-utils + jsdom)覆盖。
* 两者都要:钉子跑在零依赖的 `node --test` 里,挂载例要装 node_modules。
* 第 6 支给那枚钉子做变异自证:把提示出口在内存里摘掉,钉子必须变红(否则第 5 支恒绿)。
*/
import test from 'node:test'
import assert from 'node:assert/strict'
import { readSource } from './helpers.ts'
import {
createSummaryFailureAlerter,
markReadFailureMessage,
summaryFailureMessage,
type BellFeedbackKind,
} from '../src/layout/notification-bell-model.ts'
const BELL = 'src/components/NotificationBell.vue'
const PANEL = 'src/layout/notification-bell-panel.ts'
/** 钉子判据:两处失败路径的 console.warn 之后 160 字符窗口里必须有用户可见出口。 */
function bellFailureExits(src: string): string[] {
const missing: string[] = []
for (const token of ['未读数刷新失败', '标记已读失败']) {
const at = src.indexOf(`console.warn('[admin-notification] ${token}`)
if (at < 0) {
missing.push(`${token}:console.warn 本体都不在了(catch 被挪走或整段删除)`)
continue
}
const window = src.slice(at, at + 160)
if (!/showAdminFeedback\(|summaryFailures\.reportFailure\(/.test(window)) {
missing.push(`${token}:console.warn 之后 160 字符内没有提示出口`)
}
}
return missing
}
test('标记已读失败:文案带原因,非 Error 抛值也不塌成 undefined', () => {
assert.equal(markReadFailureMessage(new Error('500 Internal Server Error')), '这条通知没能标记为已读:500 Internal Server Error')
assert.equal(markReadFailureMessage('网关超时'), '这条通知没能标记为已读:网关超时')
assert.equal(markReadFailureMessage(undefined), '这条通知没能标记为已读')
assert.equal(markReadFailureMessage(new Error(' ')), '这条通知没能标记为已读')
})
test('未读数刷新失败:文案带原因,且与标记已读的文案分得开', () => {
assert.equal(summaryFailureMessage(new Error('401 Unauthorized')), '通知未读数刷新失败:401 Unauthorized')
assert.equal(summaryFailureMessage(null), '通知未读数刷新失败')
assert.notEqual(summaryFailureMessage(new Error('boom')), markReadFailureMessage(new Error('boom')),
'两类失败共用一句文案时,用户与排障者都分不清是轮询挂了还是点击没生效')
})
test('轮询提示闸门:同场故障只提示一次,成功一轮后重新武装', () => {
const seen: Array<{ message: string; kind: BellFeedbackKind }> = []
const alerter = createSummaryFailureAlerter((message, kind) => seen.push({ message, kind }))
assert.equal(alerter.isArmed(), false, '闸门初始应为未提示状态')
alerter.reportFailure(new Error('502'))
alerter.reportFailure(new Error('502'))
alerter.reportFailure(new Error('503'))
assert.equal(seen.length, 1, `60s 一轮的轮询不设闸就是每分钟打扰一次,实测提示 ${seen.length} 次`)
assert.deepEqual(seen[0], { message: '通知未读数刷新失败:502', kind: 'warning' })
assert.equal(alerter.isArmed(), true)
alerter.reportSuccess()
assert.equal(alerter.isArmed(), false, '成功一轮后必须重新武装,否则恢复期之后的新故障又变回静默')
alerter.reportFailure(new Error('500'))
assert.equal(seen.length, 2, '重新武装后下一次失败要再提示一次')
assert.equal(seen[1].message, '通知未读数刷新失败:500')
})
test('闸门不会把成功当失败:reportSuccess 之后再报错误仍是可见的', () => {
const seen: string[] = []
const alerter = createSummaryFailureAlerter((message) => seen.push(message))
alerter.reportFailure(new Error('第 1 次'))
alerter.reportSuccess()
alerter.reportSuccess()
alerter.reportFailure(new Error('第 2 次'))
assert.deepEqual(seen, ['通知未读数刷新失败:第 1 次', '通知未读数刷新失败:第 2 次'],
'重复 reportSuccess 不该把闸门永久卸掉,也不该把第二次故障吞掉')
})
test('源码钉子(非行为断言):两处 catch 都接到 admin-feedback-ui 的统一出口', () => {
// 10-13 两级改造后这两处 catch 长在面板模块里(SFC 顶到可读棘轮的 800 行上限,状态机整块拆出);
// 钉子跟着搬;「组件在用这一层」由 tests/mount 那支挂载用例在运行时证(这里再加一枚 readSource 就是往只许减的台账里添读点)。
const src = readSource(PANEL)
assert.ok(src.length > 0, '取样集非空自检:notification-bell-panel.ts 读到了')
assert.ok(src.includes(`import { showAdminFeedback } from '@/components/admin-feedback-ui'`),
'铃铛没接 admin-feedback-ui 的统一出口')
assert.ok(src.includes('createSummaryFailureAlerter'), '轮询闸门没在面板层实例化')
assert.deepEqual(bellFailureExits(src), [], '两处静默 catch 里有一处又退回只 console 了')
})
test('判据自证(内存变异):摘掉提示出口,上面那枚钉子必须变红', () => {
const src = readSource(PANEL)
assert.deepEqual(bellFailureExits(src), [], '基线就该是干净的,否则这条自证测不出任何东西')
const variants: Array<[string, string]> = [
['摘掉轮询提示', " summaryFailures.reportFailure(error)\n"],
['摘掉标记已读提示', " showAdminFeedback(markReadFailureMessage(error), 'error')\n"],
]
for (const [label, dropped] of variants) {
assert.equal(src.split(dropped).length - 1, 1, `「${label}」的锚串在源码里不唯一,变异不作数`)
const mutated = src.replace(dropped, '')
assert.notEqual(mutated, src, `「${label}」没删掉任何东西`)
assert.ok(bellFailureExits(mutated).length > 0, `摘掉提示出口后钉子仍然全绿=判据恒绿`)
}
})