JavaScript属性描述符是控制对象属性行为的配置项,分为数据描述符(含value/writable)和访问器描述符(含get/set),互斥;含enumerable、configurable、writable等布尔标志,用Object.defineProperty设置、Object.getOwnPropertyDescriptor查看。

JavaScript 属性描述符是用来定义和控制对象属性行为的一组配置项。它决定了属性是否可读、可写、可枚举、可配置,甚至还能自定义 getter/setter。理解它,才能真正掌握对象属性的底层控制逻辑。
数据属性 vs 访问器属性
属性描述符分为两类:数据描述符(data descriptor)和访问器描述符(accessor descriptor)。二者互斥,不能混用。
-
数据描述符:包含
value和writable,用于普通值属性。例如:{ value: 42, writable: false } -
访问器描述符:包含
get和/或set,用于有逻辑拦截的属性。例如:{ get() { return this._x * 2; }, set(v) { this._x = v / 2; } }
四个关键布尔标志的作用
每个描述符都可能包含以下可选标志,它们共同决定属性如何被使用:
-
enumerable:为
true时,该属性会在for...in循环和Object.keys()中出现 -
configurable:为
true时,才允许用Object.defineProperty()修改描述符本身,或用delete删除该属性 -
writable:仅对数据属性有效,为
false时禁止修改value - value 或 get/set:二选一,不可同时存在
如何设置和查看属性描述符
用 Object.defineProperty(obj, prop, descriptor) 设置;用 Object.getOwnPropertyDescriptor(obj, prop) 查看。
立即学习“Java免费学习笔记(深入)”;
- 设置一个只读属性:
Object.defineProperty(obj, 'age', { value: 25, writable: false, enumerable: true, configurable: false }) - 设置一个隐藏但可配置的属性:
Object.defineProperty(obj, '_id', { value: 1001, enumerable: false, configurable: true }) - 查看现有属性:
Object.getOwnPropertyDescriptor(obj, 'name')返回当前完整描述符对象
常见陷阱与注意事项
描述符操作看似简单,但容易踩坑:
- 直接赋值创建的属性,默认是
writable: true、enumerable: true、configurable: true - 一旦
configurable: false,就不能再改回true,也不能把数据属性转成访问器属性(反之亦然) -
Object.freeze()、Object.seal()、Object.preventExtensions()都是基于描述符实现的封装 - 在 class 中用
get/set定义的成员,底层就是访问器描述符










