thzxx
0dba1abf2a
工作流 C-1 / C-3 前半 + 测试代码类型检查。 【故障注入基座】新增 tests/helpers/storage-harness.ts + faulty-backend.ts - TransactionalFileStore：忠实 OPFS 提交语义（close 才可见）+ 字节级故障注入 （failNextWrite/Append/Delete、truncateAppendTo 撕裂写、crashPending 真崩溃） - 删除旧 opfs-mock：读返回内部引用、keepExistingData:false 不截断、close 空实现 导致"提交前可见"等真实缺陷无法被测出（31 个测试文件迁移至新 harness） - 删除 aria-opfs-backend 内的第三份重复 mock（含从未被断言使用的 writeCalls 死代码 与 entry.content.subarray 恒等分支） - FaultyBackend：包装任意 IStorageBackend 注入故障；crash() 明确区别于 close() （后者是优雅停机，会刷完写队列 —— 这正是此前所有"崩溃恢复"测试的真相） - 16 条基座自测证明注入真的生效（含 close 不能当崩溃的对照组） 【覆盖率口径】jest.config.cjs - 移除 '!src/**/index.ts'（该 glob 把 AriaEngine 主实现等 15 个实现文件整体 排除出统计，与 v0.2.6 曾承认过的问题同源），改为只排除纯类型声明文件并附理由 - 新增 coverageThreshold 门禁（此前完全不存在） - 真实基线：语句 90.66% / 分支 82.94% / 函数 94.36% / 行 93.43% - 修正 testMatch 使 tests/helpers 下的测试可被发现 【测试代码类型检查】tsconfig.test.json + npm run typecheck:tests - 修复 103 个测试代码类型错误（此前 babel 剥离类型 + tsconfig 排除 tests，全部隐藏） - 新增 tests/helpers/assertions.ts：nonNull/decode/rows/object/engineMethod/expectCode 以断言收窄替代 as any - 消除 21 个 lint warning（含 v043-hardening 中定义后从未调用的 mockOPFS 死代码） - parser.test.ts 12 处 toBeDefined() 空断言升级为结构断言（并新增 AND/OR 优先级用例， 当前红灯，对应总账第 11 项，将在工作流 A 修复） 【版本契约】新增 tests/version-contract.test.ts - 校验 src VERSION / package.json / dist 三者一致，替代两处硬编码版本字面量 【CI 门禁】.gitea/workflows/ci.yml - lint 去掉 continue-on-error（此前永远不让 CI 变红） - 新增 tests 类型检查、--coverage 覆盖率门禁、dist 与源码同步校验 - 版本 0.7.4 升至 0.8.0
62 lines
2.5 KiB
JavaScript
62 lines
2.5 KiB
JavaScript
module.exports = {
|
||
testEnvironment: 'jsdom',
|
||
setupFiles: ['./jest.setup.js'],
|
||
transform: {
|
||
'^.+\\.ts$': 'babel-jest',
|
||
},
|
||
transformIgnorePatterns: [
|
||
'/node_modules/(?!(@rollup)/)',
|
||
],
|
||
moduleFileExtensions: ['ts', 'js', 'json'],
|
||
// 默认 testMatch 不会发现 __tests__ 之外、名为 helpers/ 目录里的 .test.ts 文件，
|
||
// 因此显式声明匹配规则（v0.8.0：测试基座自身的自测放在 tests/helpers/ 下）。
|
||
testMatch: ['**/*.test.ts'],
|
||
// Playwright e2e（tests/e2e/）不属于 jest 单元测试
|
||
testPathIgnorePatterns: [
|
||
'/node_modules/',
|
||
'/tests/e2e/',
|
||
],
|
||
//
|
||
// v0.8.0 覆盖率口径修正（根治）：
|
||
//
|
||
// 此前为 `'!src/**/index.ts'` —— 这条 glob 把 15 个文件整体排除，其中包含
|
||
// src/engine/aria/index.ts（AriaEngine 主实现 2282 行）、src/engine/kvstore/index.ts
|
||
// （KVStore 本体）、src/hybrid/index.ts、src/migration/index.ts 等**实现文件**，
|
||
// 而非桶文件。后果：发布的"90.1% 行覆盖率"只在约 75% 的可执行源码上成立，
|
||
// 且 v0.2.6 曾在 CHANGELOG 里承认过同类问题（"91.0% 为排除 Aria 模块的陈旧数据"）
|
||
// 后又在 v0.5.1 以另一种写法复发。
|
||
//
|
||
// 现在只排除**确实没有可执行语句**的文件（纯类型声明），并且逐个显式列出、
|
||
// 附理由 —— 新增文件默认纳入统计，不会再被 glob 静默吞掉。
|
||
//
|
||
collectCoverageFrom: [
|
||
'src/**/*.ts',
|
||
// 纯类型声明：可执行语句 0 行（接口/类型别名），纳入统计只会稀释分母
|
||
'!src/engine/interface.ts',
|
||
'!src/query/ast.ts',
|
||
],
|
||
coverageDirectory: 'coverage',
|
||
coverageReporters: ['text', 'lcov'],
|
||
//
|
||
// v0.8.0 覆盖率门禁（此前完全不存在：jest.config 与 CI 都没有任何阈值，
|
||
// 覆盖率从 90% 掉到 60% 也全绿）。
|
||
//
|
||
// 阈值 = 2026-08-15 在**修正口径后**（不再排除实现文件）实测的真实基线，
|
||
// 下取整到整数百分点。v0.8.0 各阶段会持续补测，M4 收口时再上调。
|
||
// 实测基线：Statements 90.66% / Branches 82.94% / Functions 94.36% / Lines 93.43%
|
||
//
|
||
coverageThreshold: {
|
||
global: {
|
||
statements: 90,
|
||
branches: 82,
|
||
functions: 94,
|
||
lines: 93,
|
||
},
|
||
},
|
||
verbose: true,
|
||
// 注意：forceExit 会掩盖句柄/定时器泄漏。v0.8.0 保留它以便常规开发快速迭代，
|
||
// 但新增了独立的 `npm run test:leaks`（--detectOpenHandles 且不 forceExit）用于泄漏检查。
|
||
forceExit: true,
|
||
testTimeout: 15000,
|
||
};
|