JavaScript数组归约函数生成器

Reduce函数实现

函数代码

/**
 * 使用 Array.prototype.reduce 统计已支付订单的总金额与数量
 * - 仅统计 status === 'paid' 的订单
 * - 忽略 status 为 'cancelled' 或其他状态的订单
 * - 忽略无效金额（非数字 / NaN / Infinity）
 *
 * @param {Array<object>} orders - 订单数组（例如：userOrders）
 * 每个订单推荐包含以下字段：
 *   - status {string} 订单状态，示例：'paid' | 'cancelled' | ...
 *   - amount {number|string} 订单金额，支持数字或可转换为数字的字符串
 *
 * @returns {{ total: number, count: number }} 返回总金额与数量
 *   - total: 已支付订单金额求和（number）
 *   - count: 已支付订单数量（number）
 */
function summarizePaidOrders(orders) {
  // 输入校验：非数组或空数组直接返回零值结果，避免抛错并方便上层调用
  if (!Array.isArray(orders) || orders.length === 0) {
    return { total: 0, count: 0 };
  }

  // 使用 reduce 进行聚合
  const result = orders.reduce(
    (acc, order) => {
      // 跳过非对象或空值
      if (order == null || typeof order !== 'object') return acc;

      // 仅统计已支付订单
      if (order.status !== 'paid') return acc;

      // 金额转换与校验：允许字符串形式的数值（例如 "30.5"）
      const raw = typeof order.amount === 'string' ? order.amount.trim() : order.amount;
      const amount = Number(raw);

      // 忽略无效金额（NaN、Infinity、-Infinity 或非数字）
      if (!Number.isFinite(amount)) return acc;

      acc.total += amount;
      acc.count += 1;
      return acc;
    },
    { total: 0, count: 0 } // 初始累积值
  );

  return result;
}

代码说明

• 函数功能：对给定的订单数组（如 userOrders）进行归约聚合，仅统计 status 为 'paid' 的订单，计算其总金额与数量，返回 { total, count }。
• 参数说明：
  • orders：Array