本文介绍使用 JavaScript 原生 JSON.parse() 的 reviver 参数或 JSON.stringify() 的 replacer 参数，替代正则表达式对 JSON 字符串中指定字段进行条件掩码（如保留前两位+星号填充），避免字符串解析风险，确保结构安全与逻辑准确。
本文介绍使用 javascript 原生 `json.parse()` 的 reviver 参数或 `json.stringify()` 的 replacer 参数，替代正则表达式对 json 字符串中指定字段进行条件掩码（如保留前两位+星号填充），避免字符串解析风险，确保结构安全与逻辑准确。
直接操作 JSON 字符串（尤其是用正则表达式匹配键值对）极易出错：引号转义复杂、嵌套结构失效、字段名重复或含特殊字符时逻辑崩溃，且无法区分同名的嵌套属性与顶层属性。最佳实践是先解析为对象，再按需处理，最后序列化回字符串——这既符合 JSON 规范，又具备类型安全与可维护性。
✅ 推荐方案一：使用 JSON.parse() 的 reviver 函数（推荐用于「解析即掩码」场景）
reviver 是 JSON.parse() 的第二个参数，会在每个键值对被解析后立即调用，允许你动态修改值。它天然支持递归遍历所有层级，且无需手动处理引号、转义或边界匹配。
const fieldsToMask = ['TextID', 'AccountNum', 'ReturnCode'];
const jsonString = `[{"ReturnCode":0,"TextID":"nwComputedSubTotal","AccountNum":"958375845","Status":"SomeStatus"}]`;
const maskedReviver = (key, value) => {
if (fieldsToMask.includes(key)) {
const strVal = String(value); // 统一转为字符串，兼容数字/布尔等原始类型
return strVal.length <= 3 ? '***' : strVal.slice(0, 2) + '*'.repeat(strVal.length - 2);
}
return value;
};
const parsed = JSON.parse(jsonString, maskedReviver);
const resultString = JSON.stringify(parsed);
console.log(resultString);
// 输出: [{"ReturnCode":"***","TextID":"nw****************","AccountNum":"95*******","Status":"SomeStatus"}]? 注意：reviver 中 key 为空字符串 "" 表示根对象，此时 value 是整个解析后的数组或对象，可忽略；仅当 key 匹配目标字段名时执行掩码逻辑。
✅ 推荐方案二：使用 JSON.stringify() 的 replacer 函数（推荐用于「解析后定制序列化」）
若你已拥有解析后的 JS 对象（如从 API 获取的响应体），可直接用 JSON.stringify(obj, replacer) 实现掩码输出：
const data = [{"ReturnCode": 0, "TextID": "nwComputedSubTotal", "AccountNum": "958375845", "Status": "SomeStatus"}];
const maskReplacer = (key, value) => {
if (fieldsToMask.includes(key)) {
const s = String(value);
return s.length <= 3 ? '***' : s.substring(0, 2) + '*'.repeat(s.length - 2);
}
return value;
};
const maskedJson = JSON.stringify(data, maskReplacer, 2); // 第三个参数可选缩进美化
console.log(maskedJson);⚠️ 关键注意事项
- 绝不使用正则直接替换 JSON 字符串：JSON 格式严格（如键必须双引号包裹、值可能含转义引号、存在同名嵌套字段），正则无法可靠识别语义边界，极易误伤或漏处理；
- 统一类型处理：String(value) 确保数字 0、null、true 等均转为字符串再计算长度，避免 undefined.length 报错；
- padEnd() vs repeat()：示例中采用 slice(0,2) + '*'.repeat(n) 更直观可控；也可用 str.slice(0,2).padEnd(str.length, '*')，语义更清晰；
- 性能考量：对于超大 JSON，两种方案均为 O(n) 时间复杂度，远优于脆弱的多轮正则全局匹配；
- 扩展性：如需支持通配符字段（如 "*Num"）、正则匹配字段名，可在 replacer/reviver 中升级判断逻辑，仍保持结构安全。
综上，摒弃字符串层面的正则“硬编码”，拥抱 JSON 解析/序列化的标准 API，是实现健壮、可读、可维护的字段掩码逻辑的唯一正确路径。
