首页
/ React Awesome Query Builder 6.6.15版本发布:安全增强与日期功能优化

React Awesome Query Builder 6.6.15版本发布:安全增强与日期功能优化

2025-06-24 19:46:33作者:沈韬淼Beryl

React Awesome Query Builder是一个功能强大的React查询构建器组件,它允许开发者通过直观的UI界面构建复杂的查询条件。该组件支持多种UI框架(如Ant Design、Material-UI等),并能将查询条件转换为多种格式(如SQL、MongoDB查询、JsonLogic等)。

安全增强

本次6.6.15版本包含了多项重要的安全改进:

  1. 原型污染防护:修复了OtherUtils.mergeInOtherUtils.setIn方法中潜在的原型污染问题,这些方法现在会严格检查输入对象,防止不当修改原型链。

  2. XSS问题修复:针对Ant Design包中的跨站脚本(XSS)问题进行了修复,增强了组件在渲染用户输入时的安全性。

  3. 配置解压安全:改进了Utils.ConfigUtils.decompressConfig方法,防止在解压配置数据时可能发生的原型污染问题。

这些安全改进使得组件在处理用户输入和配置数据时更加可靠,特别是在需要从外部来源加载查询配置的场景下。

日期/时间功能优化

日期和时间处理是查询构建中的常见需求,本次版本对相关功能进行了全面增强:

  1. 新增日期函数

    • TODAY:获取当前日期
    • START_OF_TODAY:获取当天开始时间
    • RELATIVE_DATE:计算相对日期
    • TRUNCATE_DATETIME:截断日期时间到指定精度
  2. MongoDB日期处理修复

    • 修正了NOWRELATIVE_DATETIME函数在转换为MongoDB查询时的格式问题
    • 修复了顶级$not操作符在MongoDB输出中的使用问题
  3. JsonLogic日期比较

    • 引入了新的比较操作符date==date!=datetime==datetime!=,专门用于日期类型的精确比较
    • 新增fixJsonLogicDateCompareOp配置选项(默认关闭),用于控制是否修复JsonLogic中的日期比较操作

开发者现在可以通过Utils.JsonLogicUtils.addRequiredJsonLogicOperations(jl)方法为json-logic-js实例添加这些自定义操作符,确保日期比较在各种场景下都能正确工作。

其他改进

  1. Ant Design 4.x兼容:现在完全支持Ant Design 4.x版本的DatePicker组件,为使用较新Ant Design版本的开发者提供了更好的兼容性。

  2. 组操作符修复:修复了组操作符的自定义jsonLogic函数未被调用的问题,确保复杂的组条件能够正确转换。

  3. 依赖更新

    • @babel/runtime设为所有包的依赖项
    • 更新了vite等构建工具版本
    • 优化了整体项目依赖结构

升级建议

对于正在使用React Awesome Query Builder的项目,特别是那些涉及以下场景的,建议尽快升级到6.6.15版本:

  1. 需要处理用户输入或从外部加载查询配置的应用
  2. 大量使用日期/时间查询功能的应用
  3. 使用Ant Design 4.x作为UI框架的项目
  4. 需要将查询转换为MongoDB格式的后端应用

升级时需要注意检查自定义的操作符和日期处理逻辑,特别是如果项目中已经实现了自己的日期比较解决方案,可能需要根据新的日期比较操作符进行调整。

这个版本的发布显著提升了组件的安全性和日期处理能力,使得构建复杂查询更加可靠和灵活。对于需要精确日期操作或高安全性要求的应用场景,6.6.15版本提供了坚实的基础。

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