Apollo Client 中 MockedProvider 动态模拟数据的最佳实践

理解 MockedProvider 的工作原理

在 Apollo Client 测试中，MockedProvider 是一个关键组件，它允许开发者模拟 GraphQL 查询和变更的响应。MockedProvider 内部使用 MockLink 来处理这些模拟数据。

MockLink 在初始化时会复制传入的 mocks 数组，并在后续操作中使用这个副本，而不是持续引用原始数组。这意味着如果在测试过程中修改了原始 mocks 数组，这些更改不会自动反映在 MockLink 中。

动态添加模拟数据的挑战

许多开发者期望能够逐步构建测试场景，先设置初始模拟数据，然后在测试过程中根据需要添加更多模拟数据。这种模式在测试复杂交互流程时特别有用，例如：

1. 初始渲染时使用基本数据集
2. 用户操作后需要额外的数据
3. 验证组件在不同数据状态下的行为

然而，直接修改原始 mocks 数组不会生效，因为 MockLink 使用的是初始化时的副本。

解决方案：使用 addMockedResponse 方法

Apollo Client 提供了更可靠的方式来动态添加模拟数据。MockLink 类暴露了一个 addMockedResponse 方法，专门用于在运行时添加新的模拟响应。

这种方法比直接修改数组更可靠，因为：

• 它是官方支持的 API，不是实现细节
• 有明确的语义和预期行为
• 在未来版本中更可能保持兼容性

实际应用示例

假设我们正在测试一个显示狗狗列表的组件：

import { MockLink } from '@apollo/client/testing';

// 初始化测试
const mockLink = new MockLink(initialMocks);
const mockedProvider = new MockedProvider({
  link: mockLink,
});

// 在测试过程中动态添加新的模拟数据
mockLink.addMockedResponse({
  request: {
    query: GET_DOGS,
    variables: { id: '3' }
  },
  result: {
    data: { dog: { id: '3', name: 'Buddy' } }
  }
});

// 重新渲染组件
rerender(<ComponentUnderTest />);

最佳实践建议

1. 避免依赖实现细节：不要假设修改原始数组会自动更新模拟数据
2. 使用官方API：优先使用 addMockedResponse 方法动态添加模拟数据
3. 考虑测试结构：如果可能，预先定义所有模拟数据可以使测试更可预测
4. 封装工具函数：为常用模式创建辅助函数提高测试代码的可读性

总结

理解 MockedProvider 和 MockLink 的内部工作原理对于编写可靠的 Apollo Client 测试至关重要。虽然直接修改 mocks 数组看起来更直观，但使用官方提供的 addMockedResponse 方法能确保测试的稳定性和可维护性。通过采用这些最佳实践，开发者可以构建更健壮、更易维护的 GraphQL 组件测试套件。