编写规范的 javascript 单元测试,核心在于使用成熟的测试框架(如 jest)结合断言库,遵循 aaa(arrange-act-assert)模式,确保每个测试用例只验证一个行为,并覆盖正常、异常及边界条件。具体做法是创建以 .test.js 或 .spec.js 结尾的文件,使用 describe 组织业务模块,用 it 或 test 定义单个场景,在 beforeeach 中准备数据,调用被测函数后通过 expect 进行精确匹配。规范的关键点包括:测试名称应清晰描述输入和预期结果,避免使用模糊词汇;隔离外部依赖,使用 mock 技术模拟 api 或数据库调用;保持测试的独立性和可重复性,不依赖执行顺序。

如何组织测试文件结构与命名规范
规范的测试结构要求文件名与源文件对应,通常放在 __tests__ 目录或同级目录,后缀为 .test.js。命名上,测试套件使用 describe('模块名', ...),测试用例使用 it('应该...') 格式,明确表达意图。例如,测试一个加法函数,用例名应为 it('should return sum when given two numbers')。这种命名方式让其他开发者无需阅读代码即可理解测试目的。同时,测试文件内部应按功能分组,将相关测试用例放在一起,便于维护。

// math.test.js
const { add, divide } = require('./math');
describe('Math Utils', () => {
describe('add function', () => {
it('should return the sum of two positive numbers', () => {
expect(add(2, 3)).toBe(5);
});
it('should handle negative numbers correctly', () => {
expect(add(-1, -1)).toBe(-2);
});
});
describe('divide function', () => {
it('should throw error when dividing by zero', () => {
expect(() => divide(10, 0)).toThrow('Division by zero');
});
});
});
上述代码展示了标准的测试结构。describe 块用于逻辑分组,it 块定义具体测试。使用 require 导入被测模块。测试用例名清晰描述了输入条件和预期行为。对于异常情况的测试,使用 expect(...).toThrow() 来验证错误是否按预期抛出。这种结构确保了测试的可读性和可维护性。
如何处理依赖注入与 Mock 对象
在实际项目中,被测函数往往依赖外部服务,如数据库、API 或文件系统。规范的测试必须隔离这些依赖,使用 Mock 对象替代真实实现。Jest 提供了强大的 Mock 功能,可以使用 jest.fn() 创建模拟函数,使用 jest.spyOn() 监视现有方法的行为。Mock 对象允许你控制函数的返回值、参数和调用次数,从而专注于测试当前逻辑的正确性,而非依赖服务的稳定性。通过依赖注入或模块替换,可以将 Mock 对象传入被测函数,确保测试的纯粹性。
FilePond 是一个 JavaScript 文件上传库,支持通过拖拽、粘贴和 API 方式处理文件、目录、URL 和 Data URI。它包含内置的图像优化功能、异步分块上传功能,并提供了适用于 React、Vue、Angular 和 Svelte 的适配器。

// user.service.test.js
const UserService = require('./user.service');
const db = require('./db');
describe('UserService', () => {
let userService;
let mockDb;
beforeEach(() => {
// 创建 Mock 数据库对象
mockDb = {
findUser: jest.fn(),
saveUser: jest.fn()
};
// 将 Mock 注入服务
userService = new UserService(mockDb);
});
it('should fetch user from database and return data', async () => {
const mockUser = { id: 1, name: 'Alice' };
mockDb.findUser.mockResolvedValue(mockUser);
const result = await userService.getUser(1);
expect(result).toEqual(mockUser);
expect(mockDb.findUser).toHaveBeenCalledWith(1);
});
it('should save user and return success status', async () => {
const userData = { name: 'Bob' };
mockDb.saveUser.mockResolvedValue({ success: true });
const result = await userService.createUser(userData);
expect(result.success).toBe(true);
expect(mockDb.saveUser).toHaveBeenCalledWith(userData);
});
});
这段代码演示了如何使用 Mock 隔离数据库依赖。beforeEach 中初始化 Mock 对象并注入到 UserService。测试用例中,通过 mockResolvedValue 设定数据库返回的数据,然后调用 getUser 方法。最后,使用 toHaveBeenCalledWith 验证方法是否被正确调用,以及参数是否符合预期。这种方式确保了测试不依赖真实的数据库连接,运行速度快且稳定。
当被测函数抛出未捕获异常时测试如何响应
如果被测函数在执行过程中抛出未捕获的异常,测试框架会立即中断当前测试用例的执行,并将该测试标记为失败。规范的测试应当显式地处理异常情况,而不是依赖框架的默认行为。对于可能抛出异常的代码路径,应使用 try...catch 块包裹,并在 catch 中使用 expect 验证捕获到的错误类型和消息。或者,直接使用 Jest 提供的 expect(fn).toThrow() 语法糖,它会自动执行函数并捕获异常,简化了测试代码。无论哪种方式,都要确保测试覆盖了所有可能的错误分支,避免因未处理的异常导致测试套件意外终止。
// calculator.test.js
const Calculator = require('./calculator');
describe('Calculator division', () => {
it('should handle division by zero gracefully using try-catch', () => {
const calc = new Calculator();
try {
calc.divide(10, 0);
fail('Expected an error to be thrown');
} catch (error) {
expect(error.message).toBe('Cannot divide by zero');
expect(error.code).toBe('ERR_DIV_ZERO');
}
});
it('should throw specific error type using toThrow matcher', () => {
const calc = new Calculator();
expect(() => calc.divide(10, 0)).toThrow(new Error('Cannot divide by zero'));
});
});
第一个测试用例展示了手动捕获异常的方式,适用于需要验证错误对象的多个属性(如 message 和 code)。第二个测试用例使用了 toThrow 匹配器,更简洁地验证了异常的类型和消息。这两种方法都确保了测试能够正确识别和处理异常情况,提高了测试的健壮性。在实际开发中,应根据错误的复杂程度选择合适的验证方式。
Java免费学习笔记:立即使用
解锁 Java 大师之旅:从入门到精通的终极指南










