如何编写可测试的JavaScript代码以及有哪些最佳实践？

编写可测试的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）。

function fetchUser(id, apiClient) {
  return apiClient.get(`/users/${id}`);
}

// 测试时
const mockClient = {
  get: () => Promise.resolve({ id: 1, name: 'John' })
};

这样无需真正发起网络请求就能测试逻辑。

代码小浣熊

代码小浣熊是基于商汤大语言模型的软件智能研发助手，覆盖软件需求分析、架构设计、代码编写、软件测试等环节

51

查看详情

优先使用纯函数

纯函数是指：相同输入始终返回相同输出，且不产生副作用。这类函数最容易测试。

比如：

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');
});

测试应覆盖正常情况、边界值和错误路径。

以上就是如何编写可测试的JavaScript代码以及有哪些最佳实践？的详细内容，更多请关注php中文网其它相关文章！