JavaScript数组映射函数生成器

• 函数定义

/**
 * 将 users 数组映射为用于表格展示的行数据。
 * - id：转为字符串
 * - fullName：trim 后拼接并将每一部分首字母大写
 * - age：由 birthdate 计算（按UTC年/月/日对齐，避免时区误差）
 * - role：映射为中文标签（可自定义 roleMap）
 * - avatar：缺失或空白使用默认图片
 * - active：布尔值转中文“启用/停用”
 *
 * @param {Array<Object>} users - 原始用户数据数组
 * @param {Object} [options]
 * @param {Object<string,string>} [options.roleMap] - 角色英文代码到中文标签的映射
 * @param {string} [options.defaultAvatar] - 默认头像地址
 * @param {string} [options.roleUnknownLabel] - 未知角色的中文占位
 * @param {Date}   [options.now] - 计算年龄的基准时间（便于测试或回放）
 * @returns {Array<Object>} 转换后的表格行数据
 */
function transformUsersForTable(
  users,
  {
    roleMap = {
      admin: '管理员',
      user: '用户',
      editor: '编辑',
      viewer: '访客',
    },
    roleUnknownLabel = '未知',
    defaultAvatar = '/img/default.png',
    now = new Date(),
  } = {}
) {
  if (!Array.isArray(users)) {
    throw new TypeError('transformUsersForTable(users): users 必须为数组');
  }

  return users.map((u) => {
    const id = String(u?.id ?? '');

    const fullName = buildFullName(u?.firstName, u?.lastName);

    const age = computeAgeUTC(parseBirthdateToUTC(u?.birthdate), now);

    const role = roleMap?.[u?.role] ?? roleUnknownLabel;

    const avatar = normalizeAvatar(u?.avatar, defaultAvatar);

    const active = Boolean(u?.active) ? '启用' : '停用';

    return { id, fullName, age, role, avatar, active };
  });
}

/* ---------- 辅助函数 ---------- */

/**
 * 规范化头像：缺失、null、undefined、空字符串或全空白则使用默认。
 */
function normalizeAvatar(avatar, defaultAvatar) {
  if (typeof avatar !== 'string') return defaultAvatar;
  const trimmed = avatar.trim();
  return trimmed ? trimmed : defaultAvatar;
}

/**
 * 将 firstName/lastName 去空白后拼接，并将每一部分首字母大写。
 * 仅对拉丁字母进行大小写处理；非拉丁字符不受影响。
 */
function buildFullName(firstName, lastName) {
  const parts = [firstName, lastName]
    .map((v) => (typeof v === 'string' ? v.trim() : ''))
    .filter(Boolean)
    .map(capitalizeWord);

  return parts.join(' ');
}

/**
 * 首字母大写，其余小写（仅对英文字母有意义）。
 */
function capitalizeWord(s) {
  if (!s) return '';
  const head = s.charAt(0).toUpperCase();
  const tail = s.slice(1).toLowerCase();
  return head + tail;
}

/**
 * 将 birthdate 解析为对齐到 UTC 的日期对象（仅保留年/月/日，时间置零）。
 * 支持：
 * - 字符串：优先匹配 YYYY-MM-DD；否则退化到 new Date()
 * - Date 或毫秒时间戳
 * 解析失败返回 null。
 */
function parseBirthdateToUTC(input) {
  if (!input) return null;

  // Date 实例
  if (input instanceof Date && !Number.isNaN(input.valueOf())) {
    return new Date(Date.UTC(input.getUTCFullYear(), input.getUTCMonth(), input.getUTCDate()));
  }

  // 毫秒时间戳
  if (typeof input === 'number') {
    const d = new Date(input);
    if (!Number.isNaN(d.valueOf())) {
      return new Date(Date.UTC(d.getUTCFullYear(), d.getUTCMonth(), d.getUTCDate()));
    }
    return null;
  }

  // 字符串解析
  if (typeof input === 'string') {
    const s = input.trim();
    // 优先解析 YYYY-MM-DD，避免本地时区偏移
    const m = s.match(/^(\d{4})-(\d{1,2})-(\d{1,2})$/);
    if (m) {
      const y = +m[1];
      const mo = +m[2] - 1;
      const d = +m[3];
      return new Date(Date.UTC(y, mo, d));
    }
    // 退化解析
    const d2 = new Date(s);
    if (!Number.isNaN(d2.valueOf())) {
      return new Date(Date.UTC(d2.getUTCFullYear(), d2.getUTCMonth(), d2.getUTCDate()));
    }
  }

  return null;
}

/**
 * 基于 UTC 年/月/日计算年龄，避免时区导致的生日偏移。
 * 若 birthUTC 为空或在未来，返回 null。
 */
function computeAgeUTC(birthUTC, nowLocal = new Date()) {
  if (!birthUTC) return null;

  // 将 now 对齐到 UTC 的 Y/M/D
  const nowUTC = new Date(
    Date.UTC(
      nowLocal.getUTCFullYear(),
      nowLocal.getUTCMonth(),
      nowLocal.getUTCDate()
    )
  );

  let age = nowUTC.getUTCFullYear() - birthUTC.getUTCFullYear();

  const nowMonth = nowUTC.getUTCMonth();
  const birthMonth = birthUTC.getUTCMonth();

  if (
    nowMonth < birthMonth ||
    (nowMonth === birthMonth && nowUTC.getUTCDate() < birthUTC.getUTCDate())
  ) {
    age -= 1;
  }

  return age >= 0 ? age : null;
}

• 参数说明

1. users
   • 类型：Array