Wretch库中QueryStringAddon对undefined值的处理优化

在JavaScript的网络请求库Wretch中，QueryStringAddon插件负责将对象转换为查询字符串。近期社区发现该插件在处理undefined值时存在一个值得优化的行为：它会将undefined值转换为空字符串，而不是直接忽略该键值对。

当前实现的问题

当开发者使用如下代码发起请求时：

wretch('https://example.com')
  .addon(QueryStringAddon)
  .query({ bar: 'qwe', foo: undefined })
  .post()
  .json();

当前实现会生成URL：https://example.com?bar=qwe&foo=，其中foo=部分可能并非开发者本意。这种处理方式与许多主流HTTP客户端库(如axios)的行为不一致，后者会直接忽略值为undefined的键。

技术背景分析

在HTTP请求中，查询字符串参数值为空(param=)与完全省略参数(param)有时具有不同的语义含义。例如：

• 空值可能被服务器解释为显式的空字符串
• 省略参数则通常表示该参数未被设置

对于可选参数的处理，开发者更倾向于使用undefined来表示"不包含此参数"，而不是传递空值。当前实现强制转换undefined为空字符串，可能导致后端接收到不符合预期的值。

解决方案建议

理想的解决方案应该：

1. 默认情况下忽略undefined和null值
2. 提供配置选项允许开发者选择保留旧行为(将undefined转为空字符串)
3. 保持与社区常见实践的一致性

这种改进将使Wretch在处理可选查询参数时更加灵活和符合直觉，同时不会破坏现有代码的兼容性。开发者可以根据实际需求选择最适合的参数处理方式。

总结

查询字符串参数的处理是HTTP客户端库的重要功能之一。Wretch通过这次优化，使其在参数处理上更加灵活和符合开发者预期，进一步提升了库的实用性和易用性。这种改进也体现了开源项目响应社区反馈、持续完善自身功能的积极态度。