Apollo Client 4.0 版本中 client.query 返回值的重要变更

在 Apollo Client 的 4.0 版本中，开发团队对 client.query 方法的返回值类型进行了重要调整。这一变更旨在解决原有设计中的不合理之处，使 API 更加符合实际使用场景。

原有设计的问题

在 4.0 版本之前，client.query 方法返回的是一个 ApolloQueryResult 类型对象。这个类型包含了多个字段，其中 loading 和 networkStatus 字段在 promise-based API 的上下文中显得不太合理。

具体来说，当使用 client.query 这种 promise-based 的 API 时：

• loading 字段永远为 false，因为 promise 只有在请求完成时才会 resolve
• networkStatus 字段只能有两个可能的值：ready 或 error

这种设计不仅增加了不必要的复杂性，还可能误导开发者对这些字段的实际含义的理解。

4.0 版本的改进

在 4.0 版本中，开发团队决定移除这些不合理的字段，使返回值类型更加精简和准确。新的返回值类型不再包含 loading 和 networkStatus 字段，因为这些信息在 promise-based API 中本来就是没有意义的。

这一变更属于破坏性变更(breaking change)，意味着从 3.x 升级到 4.0 版本时，开发者需要检查代码中对这些字段的使用情况，并进行相应的调整。

对开发者的影响

对于大多数开发者来说，这一变更实际上简化了代码逻辑。开发者不再需要处理那些永远不会变化的字段，代码会更加简洁明了。

如果开发者确实需要获取请求状态信息，应该考虑使用 watchQuery 方法，该方法返回一个 Observable，可以实时反映请求的各种状态变化。

最佳实践建议

1. 在升级到 4.0 版本时，检查代码中对 client.query 返回值的处理逻辑
2. 移除对 loading 和 networkStatus 字段的任何依赖
3. 如果需要监控请求状态，考虑改用 watchQuery 方法
4. 确保团队中的所有开发者都了解这一变更，避免在代码审查时产生困惑

这一变更是 Apollo Client 向更加合理和一致的 API 设计迈出的重要一步，虽然短期内可能需要一些适配工作，但从长远来看将提高代码的可维护性和可读性。