显式设置 enumerable: true 可解决 defineProperty 添加属性默认不可枚举的问题;因未指定时 enumerable 默认为 false,导致属性在 for...in、Object.keys() 和 JSON.stringify() 中被忽略。

直接在 descriptor 中显式设置 enumerable: true,就能避免 defineProperty 添加的属性默认不可枚举的问题。
为什么没写 enumerable 就会“消失”?
Object.defineProperty() 创建或修改属性时,如果不传 enumerable 字段,它就按默认值 false 处理。这意味着该属性虽然真实存在、可读可写(取决于其他配置),但不会出现在:
-
for...in循环中 -
Object.keys()返回结果里 -
JSON.stringify()序列化结果中
这容易让人误以为属性“没加成功”,其实是被遍历机制过滤掉了。
正确写法:显式声明 enumerable
只要在 descriptor 对象中加上 enumerable: true,就能让它像普通赋值属性一样参与遍历:
const obj = {};
Object.defineProperty(obj, 'name', {
value: 'Alice',
writable: true,
enumerable: true, // ← 关键:必须写这一行
configurable: true
});
console.log(Object.keys(obj)); // ['name']
批量定义时别漏掉每个属性
用 Object.defineProperties() 一次定义多个属性时,每个子 descriptor 都要单独配 enumerable:
- 错误写法(只设了第一个):
{ a: { value: 1 }, b: { value: 2, enumerable: true } }→ a 仍不可枚举 - 正确写法:
{ a: { value: 1, enumerable: true }, b: { value: 2, enumerable: true } }
省事技巧:封装默认配置
如果项目中大量使用 defineProperty,可以封装一个工具函数,默认注入 enumerable: true:
function defineEnumProp(obj, prop, descriptor) {
Object.defineProperty(obj, prop, {
enumerable: true,
...descriptor
});
}
// 使用
defineEnumProp(obj, 'id', { value: 123, writable: false });











