属性描述符是控制对象属性行为的元数据,分数据描述符(含value/writable)和访问器描述符(含get/set),二者互斥;均支持enumerable和configurable,且configurable为false后多数特性不可改。

JavaScript 中的属性描述符是用来定义对象属性行为的一组元数据,它决定了属性是否可读、可写、可枚举、可配置,甚至还能控制属性的 getter 和 setter。通过 Object.defineProperty() 或 Object.defineProperties() 设置描述符,你可以精细地控制每个属性的表现,这是实现数据响应式、封装私有字段、防止误修改等高级操作的基础。
属性描述符的两种类型:数据描述符 vs 访问器描述符
描述符分为两类,二者互斥,不能混用:
-
数据描述符:包含
value和writable,用于普通值属性。例如:{ value: 42, writable: false }表示该属性值固定为 42,无法被重新赋值。 -
访问器描述符:包含
get和/或set函数,用于定义“计算属性”或拦截读写。例如:{ get() { return this._x * 2; }, set(v) { this._x = v / 2; } }可让属性表现得像一个派生值。
两类描述符都支持 enumerable(是否出现在 for...in 或 Object.keys() 中)和 configurable(是否能被删除或再次修改描述符本身)。注意:configurable: false 后,除了 writable(仅对数据描述符)外,其他描述符特性将永久锁定。
用 Object.defineProperty() 精确设置属性行为
这是最常用的设置方式,适用于单个属性:
立即学习“Java免费学习笔记(深入)”;
- 禁止修改已有属性:
Object.defineProperty(obj, 'name', { writable: false }) - 隐藏内部属性:
Object.defineProperty(obj, '_id', { enumerable: false }),这样JSON.stringify(obj)或遍历时不会暴露它。 - 创建只读“伪常量”:
Object.defineProperty(Math, 'PI', { writable: false, configurable: false })—— 这正是内置Math.PI的实现逻辑之一。 - 拦截赋值并校验:
{ set(val) { if (typeof val !== 'string') throw new Error('name must be string'); this._name = val; } }
批量定义与获取描述符:defineProperties 和 getOwnPropertyDescriptor
当需要一次设置多个属性时,用 Object.defineProperties() 更简洁;而要检查某个属性当前的描述符状态,用 Object.getOwnPropertyDescriptor():
Object.defineProperties(obj, { a: { value: 1, writable: false }, b: { get() { return this.a + 1; } } })-
const desc = Object.getOwnPropertyDescriptor(obj, 'a')返回完整描述符对象,可用于判断或复制行为。 - 注意:
getOwnPropertyDescriptor只查自有属性,不查找原型链上的属性。
实际应用中的关键细节
几个容易忽略但影响很大的点:
- 直接赋值(如
obj.x = 5)只触发writable检查,不触发get/set;只有通过描述符定义了访问器,才启用 getter/setter。 - 使用
Object.assign()或展开运算符复制对象时,不会复制不可枚举属性或访问器,只拷贝可枚举的数据属性。 - Vue 2 的响应式系统底层就大量依赖
Object.defineProperty()对 data 属性进行劫持;Vue 3 则改用 Proxy,因其能监听新增/删除属性,而 defineProperty 无法做到。 - 在严格模式下,向
writable: false的属性赋值会抛出错误;非严格模式则静默失败(返回原值)。











