首页
/ Redux Toolkit v2.7.0 发布:标准模式验证与无限查询优化

Redux Toolkit v2.7.0 发布:标准模式验证与无限查询优化

2025-06-04 02:00:28作者:宣海椒Queenly

Redux Toolkit 是 Redux 官方推荐的工具集,它简化了 Redux 的使用,提供了诸如 createSlicecreateAsyncThunk 和 RTK Query 等实用功能。最新发布的 v2.7.0 版本带来了几项重要改进,特别是对 RTK Query 的增强和无限查询功能的优化。

标准模式验证支持

在 API 开发中,确保服务器响应数据符合预期格式至关重要。v2.7.0 引入了对 Standard Schema 的支持,允许开发者使用如 Zod、Valibot 等验证库来验证查询参数、响应和错误。

主要特性

  • 响应验证:通过 responseSchema 选项定义响应数据的验证规则
  • 原始响应验证:使用 rawResponseSchema 在转换前验证原始数据
  • 类型推断:提供模式后可以自动推断 TS 类型,减少手动类型声明
  • 错误处理:新增 catchSchemaFailure 选项控制验证失败时的行为
  • 性能优化skipSchemaValidation 可跳过大型数据的运行时验证
import * as v from 'valibot'

const postSchema = v.object({
  id: v.number(),
  name: v.string(),
})

const api = createApi({
  endpoints: (build) => ({
    getPost: build.query({
      query: ({ id }) => `/post/${id}`,
      responseSchema: postSchema,  // 自动推断返回类型
    }),
  }),
})

无限查询功能改进

RTK Query 的无限查询功能在此版本中得到了多项修复和优化:

  1. 缓存更新:现在无限查询也支持 updateCachedData 方法
  2. 跳过机制skip 选项现在能正确工作于无限查询场景
  3. 元数据包含:无限查询的 fulfilled 动作现在包含基础查询的元数据
  4. 引用稳定性useInfiniteQuerySubscription 返回的方法现在具有稳定引用

性能优化与状态结构调整

upsertQueryEntries 在处理大量缓存条目时存在性能问题,原因是标签处理逻辑进行了过多的 O(n) 迭代。v2.7.0 重构了 state.api.provided 的数据结构,实现了标签与缓存键的反向映射,显著提升了性能。

需要注意的是,这一变更可能会影响直接访问 RTKQ 状态的代码,虽然官方不建议这样做。Redux DevTools 已发布 3.2.10 版本以兼容新旧状态结构。

其他重要改进

  • TS 支持:正式放弃对 TypeScript 5.0 的支持,目前支持 5.1-5.8
  • 中间件检查configureStore 现在会检测重复的中间件引用
  • 实体适配器createEntityAdapter 现在正确处理对同一新实体的多次更新
  • 选择器优化combineSlices 选择器现在返回相同的初始状态引用
  • API 状态重置useQuery 钩子现在能在 resetApiState 后正确重新获取数据

总结

Redux Toolkit v2.7.0 通过引入标准模式验证,使 API 数据验证更加规范和便捷;优化了无限查询的功能完整性和性能;改进了开发体验和类型支持。这些改进使得 Redux 在现代前端开发中的应用更加高效和可靠。

对于现有项目升级,建议重点关注无限查询行为的变更和状态结构的调整,确保兼容性。新项目则可以充分利用标准模式验证带来的类型安全和数据验证能力。

登录后查看全文
热门项目推荐
相关项目推荐