攻克嵌套API依赖：Nock递归Mock实战指南

攻克嵌套API依赖：Nock递归Mock实战指南

【免费下载链接】nock 项目地址: https://gitcode.com/gh_mirrors/noc/nock

你是否还在为测试中的嵌套API调用头疼？当A请求依赖B响应，B请求又依赖C数据时，传统Mock工具往往陷入"回调地狱"。本文将用15分钟带你掌握Nock的递归Mock技巧，彻底解决多层API依赖难题，让前端测试效率提升300%。

读完本文你将学会：

• 用Scope链实现API依赖的层级管理
• 动态Mock函数处理运行时依赖关系
• 录制/回放功能应对复杂调用序列
• 实战案例：电商购物车嵌套请求测试

Nock递归Mock核心原理

Nock通过Scope对象实现请求拦截的层级管理，其核心递归能力源自lib/scope.js中的链式调用设计。每个Scope实例可独立拦截特定域名请求，同时支持嵌套定义子请求规则：

// 基础递归Mock结构
const productScope = nock('https://api.example.com')
  .get('/products/1')
  .reply(200, { id: 1, name: '测试商品' })
  .get('/products/1/reviews') // 依赖商品ID的嵌套请求
  .reply(200, [{ id: 101, content: '好评' }]);

关键技术点

1. 拦截器链：Scope类的intercept方法返回Interceptor实例，支持链式调用定义多个请求规则

2. 动态响应：通过reply方法的函数参数实现运行时依赖处理：

   nock('https://api.example.com')
     .get('/cart')
     .reply(200, (uri, requestBody) => {
       // 根据请求参数动态生成响应
       const cartId = JSON.parse(requestBody).cartId;
       // 递归创建依赖Mock
       nock('https://api.example.com')
         .get(`/cart/${cartId}/items`)
         .reply(200, [{ productId: 1, quantity: 2 }]);
       return { id: cartId, status: 'active' };
     });
   

3. 持久化拦截：使用persist()方法确保递归Mock可多次触发：

   nock('https://api.example.com')
     .persist() // 关键：允许拦截器被多次调用
     .get(/.*/)
     .reply(200, (uri) => {
       // 动态生成子请求Mock
       return mockResponse(uri);
     });
   

实战：电商购物车嵌套请求测试

以下是模拟电商购物流程的递归Mock实现，包含用户认证→购物车查询→商品详情→库存检查四层依赖：

// 1. 用户认证Mock
const authScope = nock('https://auth.example.com')
  .post('/login')
  .reply(200, (uri, body) => {
    const { userId } = JSON.parse(body);
    
    // 2. 递归创建购物车Mock（依赖userId）
    nock('https://cart.example.com')
      .get(`/carts?userId=${userId}`)
      .reply(200, (uri) => {
        const cartId = 'cart_123';
        
        // 3. 递归创建购物车商品Mock（依赖cartId）
        nock('https://cart.example.com')
          .get(`/carts/${cartId}/items`)
          .reply(200, [{ productId: 'prod_456', quantity: 2 }]);
          
        return { id: cartId, userId };
      });
      
    return { token: 'fake_token', userId };
  });

录制真实请求生成Mock

对于复杂嵌套调用，可使用Nock的录制功能自动生成Mock定义：

# 录制模式运行测试
NOCK_BACK_MODE=record node test/cart.test.js

录制结果会保存为JSON文件，可通过lib/scope.js中的load方法加载：

// 加载录制的Mock定义
const cartMocks = nock.load('./recordings/cart_flow.json');

高级技巧与避坑指南

动态路径匹配

使用正则表达式匹配动态URL参数，解决递归调用中的路径变化问题：

nock('https://api.example.com')
  .get(/^\/products\/(\d+)\/related$/) // 匹配/products/123/related
  .reply(200, (uri) => {
    const productId = uri.match(/^\/products\/(\d+)/)[1];
    // 基于提取的productId创建后续Mock
  });

循环依赖处理

当A请求依赖B，B又依赖A时，可使用delay方法控制响应顺序：

// 延迟响应避免循环依赖
nock('https://api.example.com')
  .get('/a')
  .delay(100) // 关键：延迟100ms确保B的Mock已定义
  .reply(200, () => {
    return { bData: nock('https://api.example.com').get('/b').reply(200, {}) };
  });

调试技巧

启用Nock调试日志查看递归调用流程：

DEBUG=nock* node your-test.js

日志输出将显示每个拦截的请求及匹配的Mock规则，帮助定位递归逻辑问题。

总结与最佳实践

Nock的递归Mock能力通过Scope链、动态响应函数和持久化拦截三大机制实现，特别适合以下场景：

1. 复杂业务流程测试：如电商下单、支付流程等多步骤场景
2. 状态依赖接口：需要根据前序请求结果动态调整的API
3. 第三方API集成：模拟外部服务的嵌套调用

最佳实践建议：

• 对稳定的依赖链使用录制/回放模式
• 动态依赖优先使用函数式reply
• 复杂场景拆分多个独立Scope管理
• 始终配合nock.isDone()验证所有Mock都被调用

掌握这些技巧后，你将彻底摆脱测试环境依赖，让前端测试真正做到"随时随地，稳定运行"。下一篇我们将探讨Nock与Jest的深度集成，敬请关注！

本文配套代码：examples/delay-response.js
官方文档：README.md
高级用法：lib/intercept.js

【免费下载链接】nock 项目地址: https://gitcode.com/gh_mirrors/noc/nock