将JavaScript嵌套对象转换为URL稀疏字段集查询参数

const page = {
  limit: 0,
  offset: 10,
  type: {
    name: 's',
    age: 'n'
  }
};

limit=0&offset=10&type[name]=s&type[age]=n

/**
 * 将JavaScript嵌套对象转换为URL查询参数字符串，支持稀疏字段集格式。
 *
 * @param {object} obj - 要转换的JavaScript对象。
 * @param {string} [parentKey=''] - 当前递归层级的父键名，用于构建嵌套键名。
 * @returns {string} 格式化后的URL查询参数字符串。
 */
const createSparseFieldsetQuery = (obj, parentKey = '') => {
  // 使用 reduce 方法遍历对象的键
  return Object.keys(obj)
    .reduce((acc, key) => {
      // 构建当前属性的完整键名
      // 如果有父键名，则格式为 'parent[key]'；否则直接是 'key'
      const currentKey = parentKey ? `${parentKey}[${key}]` : key;
      const value = obj[key];

      // 检查值是否为非null的普通对象（非数组）
      if (typeof value === 'object' && value !== null && !Array.isArray(value)) {
        // 如果是嵌套对象，则递归调用自身
        const nestedQuery = createSparseFieldsetQuery(value, currentKey);
        if (nestedQuery) {
          acc.push(nestedQuery); // 将递归生成的查询参数添加到累加器
        }
      } else if (value !== undefined && value !== null) {
        // 如果是基本类型值（非undefined和非null），则构建键值对
        // 使用 encodeURIComponent 确保URL安全性
        acc.push(`${currentKey}=${encodeURIComponent(value)}`);
      }
      // 忽略 undefined 和 null 值
      return acc;
    }, []) // 初始累加器是一个空数组，用于收集所有参数片段
    .join('&'); // 最后将所有参数片段用 '&' 连接起来
};

const page = {
  limit: 0,
  offset: 10,
  type: {
    name: 's',
    age: 'n'
  },
  filter: {
    category: 'electronics',
    priceRange: {
      min: 100,
      max: 1000
    }
  },
  tags: ['new', 'sale'], // 数组处理可能需要额外逻辑，此处作为示例
  description: null, // null值将被忽略
  status: undefined // undefined值将被忽略
};

const queryString = createSparseFieldsetQuery(page);
console.log(queryString);
// 预期输出（注意tags数组和嵌套filter的复杂性）：
// limit=0&offset=10&type[name]=s&type[age]=n&filter[category]=electronics&filter[priceRange][min]=100&filter[priceRange][max]=1000&tags=new,sale (如果处理数组)
// 实际输出（根据当前代码，数组会被忽略，或者如果被encodeURIComponent，会是 tags[]=new&tags[]=sale 这样，但本函数未直接处理数组为多个参数）
// 对于本函数的实现，`tags: ['new', 'sale']` 会被 `typeof value === 'object'` 捕获，但 `!Array.isArray(value)` 会阻止它进入递归，最终会被忽略。
// 如果需要处理数组，例如转换为 `tags[]=new&tags[]=sale` 或 `tags=new,sale`，需要修改 `else if` 或新增一个 `else if (Array.isArray(value))` 分支。

// 根据当前代码对 page 对象的处理，实际输出会是：
// limit=0&offset=10&type[name]=s&type[age]=n&filter[category]=electronics&filter[priceRange][min]=100&filter[priceRange][max]=1000
// 因为 `tags` 是数组，`description` 是 null，`status` 是 undefined，它们被当前实现忽略了。