现代 JavaScript 教程 Mocha 测试规范：为什么要把多个断言拆分成独立的 it 测试块

文档教程前端【免费下载链接】zh.javascript.info现代 JavaScript 教程The Modern JavaScript Tutorial以最新的 ECMAScript 规范为基准通过简单但足够详细的内容为你讲解从基础到高阶的 JavaScript 相关知识。项目地址https://gitcode.com/gh_mirrors/zh/zh.javascript.info点击查看免费下载编写自动化测试时一个it里塞多个断言看起来省事却会在失败时让你陷入盲人摸象的困境。本文以《现代 JavaScript 教程The Modern JavaScript Tutorial》中 测试代码中有什么错误pow-test-wrong练习为切入点剖析这种写法的隐患并给出使用独立it测试块、it.only隔离测试的正确姿势帮助你写出可读、可定位、可维护的 Mocha 测试代码。引出问题语法正确却难以诊断的测试代码在 3-pow-test-wrong/task.md 中展示了这样一段pow函数的测试代码it(Raises x to the power n, function() { let x 5; let result x; assert.equal(pow(x, 1), result); result * x; assert.equal(pow(x, 2), result); result * x; assert.equal(pow(x, 3), result); });从语法上说这段代码完全正确测试也能通过。但它隐藏着一个典型的结构问题一个it测试块里实际上包含了三条测试只是用了一个函数把 3 个断言语句堆在了一起。偶尔这样写确实更容易可一旦发生错误到底哪个断言、哪组输入输出出了问题就变得非常不明显。如果错误发生在某个复杂的执行流的中间你甚至需要去定位那个时点的数据状态——这等于把简单的看失败信息变成了调试测试本身。错误根源断言失败会让 it 块立即终止为什么多条断言挤在一个it里这么危险这要从断言的行为说起。在 05-testing-mocha/article.md 中有明确说明当assert触发一个错误时it代码块会立即终止。因此在第一种方式中如果第一个assert失败了我们将永远不会看到第二个assert的结果。也就是说上面的测试若在pow(x, 2)处失败你不仅看不到第三个断言的执行结果Mocha 报告中也不会区分是哪个用例pow(x,1)、pow(x,2)还是pow(x,3)出错了。失败的定位粒度只有这一个it而非这一个具体用例。正确做法拆分为多个具有明确输入输出的 it 测试块3-pow-test-wrong/solution.md 给出的修复方案是用describe配合一组独立的it代码块替换掉单个itdescribe(Raises x to power n, function() { it(5 in the power of 1 equals 5, function() { assert.equal(pow(5, 1), 5); }); it(5 in the power of 2 equals 25, function() { assert.equal(pow(5, 2), 25); }); it(5 in the power of 3 equals 125, function() { assert.equal(pow(5, 3), 125); }); });改造后的测试具备两个显著优势失败信息自带语义每个it的描述如 5 in the power of 2 equals 25直接声明了输入pow(5, 2)与期望输出25。一旦某条测试失败Mocha 报告会精确指出是哪组数据不通过无需在代码里逐行推断。符合一个测试检查一个东西的规范article.md 中强调如果在一个测试代码里发现两个相互独立的检查最好拆成两个更简单的检查。独立的it让测试彼此解耦有助于我们获知代码中正在发生什么。这种拆分思路与本章其他示例一脉相承。例如 pow-2.view/test.js 就把pow(2,3)8与pow(3,4)81写成两个独立的it从而在pow的作弊实现永远返回 8下第二条测试能单独失败并暴露问题pow-3.view/test.js 甚至通过for循环配合makeTest(x)批量生成多个独立it每条都携带${x} in the power 3 is ${expected}的清晰标题。这些都印证了同一原则测试的标题与断言一一对应是定位问题的第一手信息。进阶技巧用 it.only 隔离单个测试拆分之后还不够我们还可以在调试阶段只运行其中一条测试。将it改为it.onlyMocha 就会只运行被标记的这一个代码块describe(Raises x to power n, function() { it(5 in the power of 1 equals 5, function() { assert.equal(pow(5, 1), 5); }); // Mocha 将只运行这个代码块 it.only(5 in the power of 2 equals 25, function() { assert.equal(pow(5, 2), 25); }); it(5 in the power of 3 equals 125, function() { assert.equal(pow(5, 3), 125); }); });执行上面这段代码时Mocha 会跳过第一、三条测试只执行 5 in the power of 2 equals 25 这一条。这在两类场景下尤其有用定位回归怀疑某组输入出问题时用it.only把可疑用例单独拎出来快速验证避免被其他用例的输出干扰调试测试本身正如 solution.md 指出的错误若发生在复杂执行流中间你必须找出那个时点的数据、去调试测试。此时it.only让被测用例最小化配合浏览器端的 Mocha 页面可以更专注地观察单条用例的行为。it.only属于 Mocha 的排除性 API调试完成后应记得改回it避免只跑一条测试却以为全部通过的假象。同样地describe也支持describe.only用于隔离整组测试。如何运行这些测试浏览器端 Mocha 环境上述测试运行在浏览器端的 Mocha 环境中完整的 HTML 骨架见 05-testing-mocha/index.html页面结构分为五部分head中引入 Mocha 的 CSS 与 JSmocha.setup(bdd)初始化 BDD 模式以及 Chai并把chai.assert赋给全局assert被测函数定义如function pow(x, n) { ... }测试脚本test.js即上面describe(...)/it(...)的代码div idmocha元素用于承载 Mocha 输出的测试结果通过mocha.run()启动测试。其中describe(title, function() { ... })描述被测功能it(use case description, function() { ... })用易于理解的语言描述具体用例assert.equal(value1, value2)在实现正确时不产生错误、否则抛出异常。除了assert.equalChai 还提供assert.isNaN、assert.strictEqual、assert.notEqual、assert.isTrue/assert.isFalse等断言详见 article.md 中的说明它们都遵循失败即中断当前it的行为。总结从能通过的测试到能定位的测试回到最初的问题那三段pow测试代码的错误不在于语法而在于测试的组织方式。把 3 个断言塞进一个it等于把三个可独立定位的用例合并成一个不可定位的黑盒一旦失败你不得不回溯执行流、猜测是哪组数据出了问题。规范化的写法遵循两条简单原则一个it检查一个东西把相互独立的检查拆成多个it每个it用标题写明输入与期望输出必要时用it.only隔离调试时只运行可疑用例缩小排查范围。在 BDD 流程中describe与it的标题同时充当文档与案例清晰的拆分让测试既是被执行的检查也是可阅读的行为规范。完整的pow演进示例含嵌套describe、for批量生成用例、NaN边界断言可在 pow-full.view/test.js 中查看对照本文的拆分原则你会更直观地体会到测试质量与可维护性之间的强关联。赞分享文档教程前端【免费下载链接】zh.javascript.info现代 JavaScript 教程The Modern JavaScript Tutorial以最新的 ECMAScript 规范为基准通过简单但足够详细的内容为你讲解从基础到高阶的 JavaScript 相关知识。项目地址https://gitcode.com/gh_mirrors/zh/zh.javascript.info点击查看免费下载相关推荐现代 JavaScript 教程Mocha 单元测试中“一个 it 塞进多个断言”的坑与正确写法现代 JavaScript 教程Mocha 单元测试中“一个 it 塞进多个断言”的坑与正确写法 导读本文以 zh.javascript.info 仓库中《文档教程前端JavaScript 测试代码审查实战剖析 Mocha 中“一个 it 塞多个断言”的反模式以 pow 测试为例JavaScript 测试代码审查实战剖析 Mocha 中“一个 it 塞多个断言”的反模式以 pow 测试为例 本文以 Modern JavaScrip文档/教程前端不要在单个 it 里堆砌多个 assertMocha 测试拆分的正确姿势Modern JavaScript Tutorial 实战解析不要在单个 it 里堆砌多个 assert Mocha 测试拆分的正确姿势Modern JavaScript Tutorial 实战解析 本篇文章以 en文档/教程前端创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考