Object.defineProperties 可在自定义元素原型上批量、精确配置多个属性特性（如 enumerable、configurable、get/set 等），实现精细化行为控制，比逐个调用 Object.defineProperty 更简洁高效，适用于初始化阶段统一设定只读、不可枚举、带 DOM 同步逻辑的响应式属性。
使用 Object.defineProperties 可以在自定义元素原型上批量、精确地定义多个属性的特性（如是否可枚举、可配置、可写、getter/setter 等），从而实现对属性行为的精细化控制。这比逐个用 Object.defineProperty 更简洁，也更适合初始化阶段统一配置。
明确目标：为什么要在自定义元素原型上用 defineProperties
自定义元素（如 class MyButton extends HTMLElement）的原型是属性和方法的“模板”。直接在原型上定义属性时，若不显式设置描述符，默认会生成可写、可枚举、可配置的属性——这往往不符合封装需求。例如，你可能希望：
- 暴露只读的
version字段（不可写、不可配置） - 让内部状态
_state不可枚举（避免for...in泄露） - 为
disabled提供带 DOM 同步逻辑的 getter/setter
基础写法：在 customElements.define 前配置原型
必须在调用 customElements.define() 之前操作原型，否则已注册的元素实例不会继承新定义的属性描述符（尤其涉及 get/set 的属性）。
示例：为 my-counter 定义三个受控属性：
立即学习“前端免费学习笔记（深入）”；
class MyCounter extends HTMLElement {
constructor() {
super();
this._count = 0;
}
}
Object.defineProperties(MyCounter.prototype, {
count: {
get() { return this._count; },
set(value) {
const oldValue = this._count;
this._count = Math.max(0, Number(value));
this.dispatchEvent(new CustomEvent('countchange', { detail: { oldValue, newValue: this._count } }));
},
enumerable: true,
configurable: false
},
version: {
value: '1.2.0',
writable: false,
enumerable: true,
configurable: false
},
isInitialized: {
get() { return this.hasAttribute('data-initialized'); },
set(val) { this.toggleAttribute('data-initialized', Boolean(val)); },
enumerable: false,
configurable: false
}
});
customElements.define('my-counter', MyCounter);
关键细节：描述符组合的实际影响
不同描述符组合会显著改变属性行为，需按需取舍：
-
configurable: false：之后无法删除该属性，也无法再次调用defineProperty修改其描述符（value或get/set除外）——适合稳定接口 -
enumerable: false：该属性不会出现在for...in、Object.keys()中，但可通过Object.getOwnPropertyNames()查到——适合隐藏内部状态 -
不设
writable时，value才生效；设了get/set就自动忽略writable和value——避免混用冲突 - 若同时需要
get和set，二者必须成对出现或都省略；只设一个会报错
避坑提醒：常见错误与替代思路
以下情况容易出错，建议提前检查：
- 在
connectedCallback或实例方法中对原型调用defineProperties—— 此时元素已注册，新描述符对已有实例无效 - 给 getter/setter 属性设
writable: true—— 会被忽略，且可能掩盖逻辑错误 - 误将实例私有字段（如
this.#private）暴露为原型属性 —— 应始终通过this._命名约定或WeakMap管理私有状态 - 过度使用
defineProperties替代简单赋值 —— 若只是普通可写属性，直接MyCounter.prototype.foo = 'bar'更轻量
