用途:使用 Node.js 原生测试运行器(node:test)为 JavaScript 文件编写和维护单元测试,适合新建脚本、修复缺陷以及被提示缺少测试时使用。
何时需要测试:scripts/quality/ 下的每个新脚本都需要测试;缺陷修复需要测试以复现并验证修复;重构需验证现有测试仍通过;src/ 组件测试为可选,鼓励但不强制。
测试文件约定:脚本 scripts/quality/foo-bar.js 对应测试 tests/unit/validators/foo-bar.test.js。
主要能力:从 node:test 导入 describe、it、before、after、beforeEach、afterEach,从 node:assert 使用 strictEqual、ok、match、throws、rejects、deepStrictEqual 等断言。运行命令:npm test、npm run test:all、node --test tests/unit/validators/foo.test.js、npm run test:coverage。
最低要求:每个脚本测试文件应包含正常路径、错误处理和边界条件三类测试。CLI 工具可通过 execSync 执行脚本并校验输出,例如 -help 应匹配 Usage:。
夹具目录:tests/unit/fixtures/valid/ 与 tests/unit/fixtures/invalid/<validator-name>/。相关文档有 PATTERNS.md、FIXTURES.md,相关技能包括 javascript-author、backend-testing、dependency-wrapper、vitest。