mocha负责测试组织与运行,chai提供可读断言;需安装dev依赖、配置scripts、用describe/it构建测试结构,推荐expect风格链式断言,并覆盖同步异常和异步逻辑。

在 JS 项目中用 Mocha 配合 Chai 做断言测试,核心是分工明确:Mocha 负责组织和运行测试结构,Chai 提供自然、可读的断言表达。只要装好、写对风格、断言到点上,就能快速验证函数行为是否符合预期。
安装与基础配置
先确保项目已初始化(npm init -y),再安装开发依赖:
- npm install --save-dev mocha chai
- 在 package.json 的 scripts 中加入:
"test": "mocha"(默认会找 test/**/*.js 或 **/*.test.js) - 创建 test/ 目录,比如写一个 math.test.js
用 describe 和 it 搭建测试结构
Mocha 用 describe 定义测试套件(比如一个模块或函数名),用 it 描述具体场景(即“它应该……”):
DMap GL地图JSAPI(dmapgl)开发指南。用于编写、审查、调试 DMap 地图 API 代码,涵盖地图初始化、覆盖物渲染、图层管理、事件处理、控件交互等任务。当用户提及 dmap、dmapgl、jsapi‑gl 或相关地图开发需求时自动触发。
- 每个 it 是一个独立测试用例,失败互不影响
- 支持嵌套 describe,便于按功能分组,例如:
describe('Calculator', () => { describe('add', () => { it('should return 5 when adding 2 and 3', ...) - 测试文件无需导出,Mocha 会自动加载执行
选一种 Chai 断言风格并保持一致
Chai 支持三种语法,推荐使用 expect 风格——链式调用清晰、容错好、易扩展:
- 引入:const { expect } = require('chai');
- 基本写法:expect(result).to.equal(5);、expect(fn).to.throw(TypeError);
- 常用链式断言:.to.be.true、.to.have.lengthOf(3)、.to.include('error')
- 避免混用 assert 和 should,尤其团队协作时统一风格能减少理解成本
覆盖异常和异步逻辑
真实业务常涉及报错和等待,这两类必须显式测到:
- 同步报错:构造非法输入,用 expect(() => fn(invalid)).to.throw('Invalid input');
- 异步 Promise:返回 Promise 并用 .eventually,如
return expect(fetchData()).to.eventually.have.property('data'); - async/await 写法更直观:
it('handles API failure', async () => { await expect(apiCall()).to.be.rejectedWith(Error); });










