Reflect.defineProperty 的描述符深度处理-js教程-PHP中文网

reflect.defineproperty的描述符是严格约束属性行为的元数据契约，分为互斥的数据描述符（value/writable）和访问器描述符（get/set），configurable为总开关，enumerable和writable深层影响调试与序列化，proxy中需协同捕获器校验。

reflect.defineproperty 的描述符深度处理

Reflect.defineProperty 的描述符不是“配置项列表”，而是一套严格约束属性行为的元数据契约。它决定属性如何被读、写、枚举、删除，甚至是否允许后续修改描述符本身。处理它不能只看字段有无，关键在于理解每个字段的语义边界和组合逻辑。

描述符类型必须明确区分

描述符分为两类：数据描述符（含 value/writable）和访问器描述符（含 get/set）。二者互斥——不能同时设置 value 和 get，也不能同时设 writable 和 set。否则 Reflect.defineProperty 会直接返回 false（非报错），且不生效。

数据描述符示例：{ value: 42, writable: true, enumerable: true, configurable: true }
访问器描述符示例：{ get() { return this._x; }, set(v) { this._x = v; }, enumerable: true, configurable: true }
混合写法（如 { value: 1, get() {} }）将被静默拒绝，返回 false

configurable 是所有行为的“总开关”

当 configurable: false 时，该属性几乎不可逆：无法删除、无法改 descriptor（包括 writable → false 后不能再变 true）、无法从数据描述符转为访问器描述符。即使 Reflect.defineProperty 调用成功（返回 true），后续任何违反该约束的操作都会失败。

Google Maps Agent

一款AI开发辅助工具，主要用于Google地图应用构建智能体工具，适合需要提升相关任务效率的用户。

下载

已设 configurable: false 的属性，再次调用 Reflect.defineProperty 修改 enumerable 或 writable 可能成功（只要不违反当前状态）
但试图把 writable: false 改成 true，或删掉该属性，都会返回 false
冻结对象（Object.freeze）后所有属性自动变为 configurable: false，此时 Reflect.defineProperty 对任何新属性都返回 false

enumerable 和 writable 的实际影响常被低估

这两个布尔值不只控制 for...in 或赋值动作，更深层影响调试、序列化和代理行为：

enumerable: false → 属性不会出现在 Object.keys()、JSON.stringify() 中，也不会被 for...in 遍历，但可通过 Reflect.ownKeys() 获取
writable: false → 禁止通过 = 赋值覆盖，但不阻止通过 Reflect.set() 或 Object.defineProperty() 重新定义（前提是 configurable: true）
若同时设 writable: false 和 configurable: false，该属性就变成真正意义上的“常量字段”，连 descriptor 都无法再动

与 Proxy defineProperty 捕获器协同时的描述符校验

当目标对象是 Proxy，且 handler 定义了 defineProperty 捕获器时，Reflect.defineProperty 的调用会触发该捕获器，并把 descriptor 作为第三个参数传入。此时 descriptor 会先经捕获器逻辑处理，再交由底层 [[DefineOwnProperty]] 执行。