可通过定义toJSON方法自定义JSON.stringify行为，该方法需为对象自有可枚举函数、无参数，返回JSON可序列化值；返回undefined/函数/Symbol时字段被忽略，抛异常则整个序列化失败。
JavaScript中对象序列化时，如果希望自定义JSON.stringify()的行为，可以通过在对象上定义toJSON方法来实现。该方法会在序列化过程中被自动调用，返回的值将代替原对象参与后续JSON转换。
toJSON方法的基本规则
toJSON是一个普通函数，必须是对象自身拥有的可枚举方法（不能是原型链继承来的，除非显式绑定），且无参数。它应返回一个能被JSON.stringify正常处理的值（如字符串、数字、布尔、数组、普通对象或null）。
- 若返回基本类型（如字符串、数字），直接作为该字段的序列化结果
- 若返回对象或数组，会递归调用其内部属性的
toJSON（如有） - 若返回
undefined、函数或Symbol，该字段在JSON中会被忽略（等效于删除） - 若抛出异常，整个
JSON.stringify调用失败
常见使用场景与写法
适用于隐藏敏感字段、格式化日期、简化嵌套结构或适配API接口要求。
- 隐藏密码字段：
toJSON() { const { password, ...rest } = this; return rest; } - 格式化日期：
toJSON() { return this.date.toISOString(); } - 扁平化嵌套对象：
toJSON() { return { id: this.id, name: this.profile?.name || '' }; } - 兼容后端字段命名：
toJSON() { return { user_id: this.id, full_name: this.name }; }
注意点与陷阱
容易忽略但关键的细节：
立即学习“Java免费学习笔记（深入）”；
-
toJSON只在JSON.stringify中生效，不影响console.log或普通赋值 - 箭头函数无法作为
toJSON，因其不绑定this，会导致上下文丢失 - 类实例需确保
toJSON定义在实例上（构造函数内赋值）或原型上（推荐），否则可能不被识别 - 循环引用检测仍由
JSON.stringify自身执行，toJSON不能绕过该限制
完整示例
定义一个用户类，控制序列化输出：
class User {
constructor(id, name, email, password) {
this.id = id;
this.name = name;
this.email = email;
this.password = password;
}
toJSON() {
// 过滤敏感字段，并添加时间戳
return {
id: this.id,
name: this.name,
email: this.email,
created_at: new Date().toISOString()
};
}
}
const user = new User(123, 'Alice', 'a@example.com', 'secret123');
console.log(JSON.stringify(user));
// → {"id":123,"name":"Alice","email":"a@example.com","created_at":"2024-05-20T10:30:45.123Z"}
