JavaScript实现通用的字符串数据脱敏工具

function createMasker(options = {}) {
    const { keepHead = 1, keepTail = 1, maskChar = '*' } = options;

    return function(str) {
        // 增加类型校验，提高健壮性
        if (typeof str !== 'string') return str;
        
        const len = str.length;
        
        // 如果字符串总长度不足以同时保留头部和尾部，则原样返回
        // (也可根据业务需求改为：保留头部，其余全部打码)
        if (len <= keepHead + keepTail) {
            return str;
        }

        // 动态计算需要掩盖的长度，确保脱敏后的字符串总长度与原字符串严格一致
        const maskLen = len - keepHead - keepTail;
        const maskStr = maskChar.repeat(maskLen);
        
        return str.slice(0, keepHead) + maskStr + str.slice(len - keepTail);
    };
}

// ================= 使用示例 =================

// 1. 身份证常见格式 (18位)
const maskIdCard = createMasker({ keepHead: 6, keepTail: 4 });
console.log("18位身份证:", maskIdCard("411329198501125032")); 
// 输出: 411329********5032

// 2. 手机号码 (11位)
const maskPhone = createMasker({ keepHead: 3, keepTail: 4 });
console.log("11位手机号:", maskPhone("13812345678")); 
// 输出: 138****5678

// 3. 更长的字符串 (20位) - 证明动态长度计算有效
const maskLong = createMasker({ keepHead: 4, keepTail: 4 });
console.log("20位长字符串:", maskLong("12345678901234567890")); 
// 输出: 1234************7890 (中间12个*)

// 4. 极短字符串 (小于 keepHead + keepTail)
console.log("极短字符串:", maskIdCard("12345")); 
// 输出: 12345 (原样返回，避免 slice 逻辑错乱)

/**
 * 数据脱敏工具类
 */
class MaskerUtils {
  /**
   * 核心通用脱敏方法
   * @param {string} str - 需要脱敏的原始字符串
   * @param {Object} options - 配置项
   * @param {number} options.keepHead - 头部保留的字符数，默认 1
   * @param {number} options.keepTail - 尾部保留的字符数，默认 1
   * @param {string} options.maskChar - 掩盖字符，默认 '*'
   * @returns {string} 脱敏后的字符串
   */
  static mask(str, options = {}) {
    if (typeof str !== 'string') return str;
    
    const { keepHead = 1, keepTail = 1, maskChar = '*' } = options;
    const len = str.length;

    // 如果字符串总长度不足以同时保留头部和尾部，则原样返回
    if (len <= keepHead + keepTail) {
      return str;
    }

    // 动态计算需要掩盖的长度，确保脱敏后总长度不变
    const maskLen = len - keepHead - keepTail;
    const maskStr = maskChar.repeat(maskLen);

    return str.slice(0, keepHead) + maskStr + str.slice(len - keepTail);
  }

  /**
   * 身份证号脱敏 (默认 18位: 保留前6后4)
   * @param {string} idCard 
   * @returns {string}
   */
  static idCard(idCard) {
    return this.mask(idCard, { keepHead: 6, keepTail: 4 });
  }

  /**
   * 手机号脱敏 (默认 11位: 保留前3后4)
   * @param {string} phone 
   * @returns {string}
   */
  static phone(phone) {
    return this.mask(phone, { keepHead: 3, keepTail: 4 });
  }

  /**
   * 银行卡号脱敏 (默认保留前4后4)
   * @param {string} bankCard 
   * @returns {string}
   */
  static bankCard(bankCard) {
    return this.mask(bankCard, { keepHead: 4, keepTail: 4 });
  }

  /**
   * 姓名脱敏 (特殊规则)
   * - 2个字: 张* 
   * - 3个字: 张*三
   * - 4个字及以上: 张**四 (保留首尾，中间全部脱敏)
   * @param {string} name 
   * @returns {string}
   */
  static name(name) {
    if (typeof name !== 'string') return name;
    const len = name.length;
    
    if (len === 0) return name;
    if (len === 1) return name; // 单字姓名不脱敏或按业务需求处理
    if (len === 2) return this.mask(name, { keepHead: 1, keepTail: 0 });
    if (len === 3) return this.mask(name, { keepHead: 1, keepTail: 1 });
    
    // 4个字及以上，保留第1个和最后1个
    return this.mask(name, { keepHead: 1, keepTail: 1 });
  }

  /**
   * 邮箱脱敏 (保留前3位和 @ 及之后的域名部分)
   * @param {string} email 
   * @returns {string}
   */
  static email(email) {
    if (typeof email !== 'string' || !email.includes('@')) return email;
    
    const [prefix, domain] = email.split('@');
    if (prefix.length <= 3) {
      return this.mask(email, { keepHead: 1, keepTail: domain.length + 1 });
    }
    // 保留前3位，其余用户名部分打码
    const maskedPrefix = this.mask(prefix, { keepHead: 3, keepTail: 0 });
    return `${maskedPrefix}@${domain}`;
  }
}

// 兼容 CommonJS 和 ES Modules 导出
if (typeof module !== 'undefined' && module.exports) {
  module.exports = MaskerUtils;
} else {
  // 浏览器环境可挂载到 window (可选)
  // window.MaskerUtils = MaskerUtils;
}

// 1. 使用预置的常用方法 (推荐，最简洁)
console.log(MaskerUtils.idCard("411329198501125032")); // "411329********5032"
console.log(MaskerUtils.phone("13812345678"));         // "138****5678"
console.log(MaskerUtils.bankCard("6222021234567890123")); // "6222***********0123"

console.log(MaskerUtils.name("张三"));                 // "张*"
console.log(MaskerUtils.name("张三丰"));               // "张*丰"
console.log(MaskerUtils.name("欧阳明日"));             // "欧**日"

console.log(MaskerUtils.email("zhangsan@example.com")); // "zha*******@example.com"
console.log(MaskerUtils.email("li@test.com"));          // "l**@test.com"


// 2. 使用通用 mask 方法处理特殊需求
// 例如：订单号保留前4后4，使用 '#' 作为掩盖字符
const orderNo = "ORD202310240001";
console.log(MaskerUtils.mask(orderNo, { keepHead: 4, keepTail: 4, maskChar: '#' })); 
// 输出: "ORD2########0001"


// 3. 容错性测试 (传入非字符串不会报错)
console.log(MaskerUtils.phone(null));          // null
console.log(MaskerUtils.name(undefined));      // undefined
console.log(MaskerUtils.idCard("12345"));      // "12345" (长度不足，原样返回)