Undici项目Mock功能增强：如何获取所有拦截请求记录

在Node.js生态中，Undici作为一款高性能HTTP客户端库，其Mock功能在测试场景中发挥着重要作用。近期社区针对Mock功能提出了一个增强需求：如何有效获取所有被拦截的HTTP请求记录用于测试断言。

需求背景

在自动化测试中，我们经常需要验证代码是否按预期发送了正确的HTTP请求。特别是在GitHub Action等CI/CD场景中，开发者需要确保应用发送的每个请求都符合预期。传统做法是通过日志记录请求信息，但这会导致测试代码与日志输出强耦合。

解决方案演进

Undici在较新版本中已经内置了MockCallHistory功能，这正是解决此类问题的理想方案。该API允许开发者：

1. 完整记录所有被Mock代理拦截的HTTP请求
2. 以结构化数据形式提供请求详情
3. 支持在测试断言中直接验证请求内容

实现原理

MockCallHistory本质上是一个请求日志收集器，它会自动记录以下关键信息：

• 请求方法（GET/POST等）
• 请求URL路径
• 请求头信息
• 请求体内容
• 响应状态码

这些数据以数组形式存储，开发者可以随时访问并进行断言验证。

最佳实践

在实际测试中，推荐这样使用：

// 初始化MockAgent时启用callHistory
const mockAgent = new MockAgent()
mockAgent.enableNetConnect()

// 测试用例中验证请求
const calls = mockAgent.callHistory()
assert.equal(calls.length, 2)
assert.equal(calls[0].path, '/api/v1/users')

版本兼容性说明

需要注意的是，该功能是在Undici较新版本中加入的。如果开发者遇到无法访问callHistory的情况，首先应该检查Undici版本，确保使用的是支持此功能的最新稳定版。

总结

Undici的MockCallHistory功能为HTTP请求测试提供了强大支持，使开发者能够：

• 更清晰地组织测试代码
• 减少对日志输出的依赖
• 编写更精确的请求验证逻辑
• 提高测试的可维护性

对于需要进行HTTP请求验证的Node.js项目，这无疑是一个值得采用的测试方案。