Mocha JavaScript 测试框架 (Node.js)：完整指南与实战示例

1. 什么是 Mocha？为什么需要它？

Mocha 是一个功能强大、灵活且广泛使用的 JavaScript 测试框架，可在 Node.js 环境和浏览器中运行。它由开发者 TJ Holowaychuk 于 2011 年创建，此后成为 JavaScript 应用程序测试的事实标准之一。Mocha 为开发者提供了简洁、模块化且富有表现力的 API，用于编写简单的单元测试，以及复杂的集成测试和异步测试场景。

Mocha 的核心目标是让测试过程尽可能简单直观。与其他一些框架不同，Mocha 不强加严格的测试结构，也不包含内置的断言库。相反，它提供了一个用于组织测试（describe/it/hooks）并以各种报告格式（reporters）运行测试的框架，将断言库的选择权留给开发者。这使得 Mocha 极其灵活：你可以将其与内置的 assert 模块、流行的 Chai 库（提供 BDD/TDD 风格）、Should.js 或任何其他库一起使用。

为什么需要 Mocha？在现代软件开发中，测试不是奢侈品，而是必需品。Mocha 可以自动检查代码的正确性，在修改后检测回归问题，记录函数和模块的行为，并提高应用程序的整体可靠性和稳定性。凭借对异步测试（回调、Promise、async/await）的支持以及与各种断言库的兼容性，Mocha 非常适合测试 Node.js 服务器端应用程序、API、数据库以及任何其他组件。

2. 安装 Mocha

Mocha 通过 npm（Node 包管理器）安装。建议将其安装为开发依赖（devDependency），因为测试在生产环境中不需要。

安装命令：

npm install --save-dev mocha

安装后，你可以在 package.json 文件中添加脚本来运行测试：

{
  "scripts": {
    "test": "mocha"
  }
}

现在可以使用以下命令运行测试：

npm test

全局安装（不推荐，但可行）：

npm install -g mocha

3. 快速入门——最小工作示例

创建一个 test.js 文件，内容如下：

const assert = require('assert');

// 要测试的函数
function add(a, b) {
  return a + b;
}

// 测试套件 (suite)
describe('add 函数', function() {
  // 具体测试用例 (spec)
  it('应返回两个数字的和', function() {
    // 断言 (assertion)
    assert.strictEqual(add(2, 3), 5);
  });

  it('应能处理负数', function() {
    assert.strictEqual(add(-1, -1), -2);
  });
});

运行测试：