属性描述符是控制对象属性行为的元数据,分数据描述符(含value/writable)和访问器描述符(含get/set),二者互斥;均支持enumerable和configurable,且configurable为false后多数特性不可改。
JavaScript 中的属性描述符是用来定义对象属性行为的一组元数据,它决定了属性是否可读、可写、可枚举、可配置,甚至还能控制属性的 getter 和 setter。通过 Object.defineProperty() 或 Object.defineProperties() 设置描述符,你可以精细地控制每个属性的表现,这是实现数据响应式、封装私有字段、防止误修改等高级操作的基础。
描述符分为两类,二者互斥,不能混用:
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() 精确设置属性行为这是最常用的设置方式,适用于单个属性:
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; } }
当需要一次设置多个属性时,用 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() 或展开运算符复制对象时,不会复制不可枚举属性或访问器,只拷贝可枚举的数据属性。Object.defineProperty() 对 data 属性进行劫持;Vue 3 则改用 Proxy,因其能监听新增/删除属性,而 defineProperty 无法做到。writable: false 的属性赋值会抛出错误;非严格模式则静默失败(返回原值)。