Apollo Client v4.0.0-alpha.8 测试版发布：MockLink与错误处理的重大改进

项目简介

Apollo Client 是一个强大的 GraphQL 客户端库，广泛应用于现代前端开发中。它提供了数据管理、缓存、错误处理等一系列功能，帮助开发者高效地与 GraphQL API 交互。本次发布的 v4.0.0-alpha.8 版本是 4.0 大版本更新前的测试版本，主要针对测试工具 MockLink 和错误处理机制进行了重大改进。

主要变更内容

MockLink 的重大改进

1. 默认延迟行为变更

   现在所有通过 MockLink 传递的模拟响应默认会使用 realisticDelay 函数添加延迟。这一改变确保了测试能够正确处理加载状态，不再依赖于特定的时间点。开发者可以通过设置全局或实例级别的默认值来覆盖这一行为。

2. 变量匹配器简化

   移除了 variableMatcher 选项，现在直接在 request.variables 中传递回调函数来判断是否匹配请求变量。这一变更使 API 更加直观和简洁。

3. 移除 newData 选项

   移除了原本的 newData 选项，推荐使用 result 回调函数配合 maxUsageCount 选项来实现类似功能。这一变化统一了 API 设计，减少了概念上的冗余。

4. 延迟配置增强

   现在 delay 选项可以接受回调函数，根据当前操作动态决定延迟时间。同时引入了 realisticDelay 辅助函数，可以生成 20-50ms 之间的随机延迟，更接近真实网络环境。

错误处理机制重构

1. 统一错误报告

   onError 链接现在使用单一的 error 属性来报告错误，而不是分开的 graphQLErrors 和 networkError。错误可能是 CombinedGraphQLErrors、CombinedProtocolErrors 或其他非 GraphQL 错误的实例。

2. 移除废弃 API

   移除了 ApolloLink 中的 onError 和 setOnError 方法，这些方法原本只被 MockLink 用于重写错误。

其他重要变更

1. 入口点统一

   @apollo/client 和 @apollo/client/core 入口点现在功能相同，为未来移除 @apollo/client/core 做准备。

2. 客户端查询验证

   现在当在 MockLink 的模拟响应中使用客户端查询时会抛出错误，防止误用。

技术影响与最佳实践

这些变更对开发者测试 GraphQL 应用的方式产生了重要影响：

1. 更真实的测试环境

   默认的 realisticDelay 行为迫使开发者考虑加载状态的处理，使测试更接近真实用户体验。

2. 更清晰的错误处理

   统一的错误报告机制简化了错误处理逻辑，使代码更加清晰和一致。

3. 更灵活的模拟配置

   延迟回调函数和全局/实例级别的默认配置提供了更大的灵活性，可以针对不同测试场景进行优化。

对于升级到这一版本的开发者，建议：

• 检查并更新所有使用 variableMatcher 的测试代码
• 将 newData 用法迁移到 result 回调
• 评估默认延迟行为对现有测试的影响
• 更新错误处理逻辑以适应新的统一错误报告机制

总结

Apollo Client v4.0.0-alpha.8 通过改进 MockLink 和错误处理机制，为开发者提供了更强大、更一致的测试工具。这些变更不仅提高了测试的真实性，还简化了 API 设计，为即将到来的 4.0 正式版奠定了坚实基础。开发者应尽早尝试这一测试版本，为未来的升级做好准备。