编写可测试的JavaScript代码需遵循模块化、解耦和职责清晰原则。1. 保持函数小而单一，每个函数只做一件事，便于独立测试；2. 避免直接依赖全局状态和副作用，将如Date.now()等外部依赖作为参数传入，提升可预测性；3. 使用依赖注入解耦外部服务，使API调用可被模拟；4. 优先使用纯函数，确保输入输出确定且无副作用；5. 按功能组织代码结构，合理划分模块与目录，便于测试文件导入和调用；6. 编写描述性强的测试用例，覆盖正常路径、边界值和错误场景。通过这些实践，代码更易维护和验证，降低后期成本。
编写可测试的 JavaScript 代码，关键在于让代码模块化、解耦、职责清晰。这样不仅便于维护，也更容易通过单元测试、集成测试来验证行为是否正确。以下是实用的最佳实践。
保持函数小而单一
每个函数应只做一件事，并且做好。这样的函数容易理解、复用和测试。
例如：
// 不推荐
function processUserData(user) {
if (!user.name) throw new Error('Name is required');
const formatted = user.name.trim().toUpperCase();
localStorage.setItem('user', formatted);
return formatted;
}
// 推荐
function validateUser(user) {
if (!user.name) throw new Error('Name is required');
}
function formatName(name) {
return name.trim().toUpperCase();
}
function saveUser(name) {
localStorage.setItem('user', name);
}
拆分后，每个函数都可以独立测试，无需模拟副作用或处理多种逻辑分支。
立即学习“Java免费学习笔记（深入）”；
避免直接依赖全局状态和副作用
直接操作 DOM、localStorage、Date.now() 或 Math.random() 会让测试变得不可控。应该将这些依赖作为参数传入，或通过依赖注入的方式提供。
示例：把时间依赖外置
function logMessage(message, now = Date.now()) {
return { message, timestamp: now };
}
测试时可以传入固定时间戳，确保结果可预测。
使用依赖注入解耦外部服务
不要在函数内部硬编码 API 调用或第三方库。通过参数传入依赖，方便在测试中替换为模拟对象（mock）。
java-api-doc-generator
下载
分析 Java Spring Boot 后端 Controller 代码，自动生成 Markdown 格式的接口文档。当用户说“生成 Java 接口文档”、“生成 API 文档”、“从 Spring 代码生成文档”时触发。
function fetchUser(id, apiClient) {
return apiClient.get(`/users/${id}`);
}
// 测试时
const mockClient = {
get: () => Promise.resolve({ id: 1, name: 'John' })
};
这样无需真正发起网络请求就能测试逻辑。
优先使用纯函数
纯函数是指：相同输入始终返回相同输出，且不产生副作用。这类函数最容易测试。
比如：
function add(a, b) {
return a + b;
}
一行断言即可覆盖测试：expect(add(2, 3)).toBe(5);
组织代码结构利于测试
按功能划分模块，避免将所有逻辑塞进一个文件。使用 ES 模块或 CommonJS 明确导出可测试的部分。
目录建议：
- src/utils/format.js
- src/services/api.js
- tests/utils/format.test.js
- tests/services/api.test.js
确保测试文件能轻松导入并调用目标函数。
编写可读性强的测试用例
使用描述性名称说明测试意图。推荐使用 Jest 或 Vitest 等现代测试框架。
test('formatName trims and converts to uppercase', () => {
expect(formatName(' john ')).toBe('JOHN');
});
测试应覆盖正常情况、边界值和错误路径。
基本上就这些。写可测试的代码本质上是在写高质量的代码——关注分离、低耦合、高内聚。一开始多花点时间设计，后期省下的调试和维护成本会非常可观。
