第43章 属性装饰器
题目:属性装饰器——验证属性赋值
定义一个 User 类,其 age 属性只能赋 0~120 之间的整数。利用 TypeScript 属性装饰器在赋值时自动校验,非法值抛出错误,合法值正常存储。
设计思路
属性装饰器接收“原型”和“属性名”,通过 Object.defineProperty 重写 getter/setter。在 setter 中执行校验逻辑,通过则写入内部存储,否则抛出 Error。装饰器工厂可传入验证函数,便于复用。
核心技巧:装饰器工厂 + defineProperty 拦截赋值,实现声明式校验。
核心代码
function validate(min: number, max: number) {
return function (target: any, key: string) {
let value = target[key];
Object.defineProperty(target, key, {
get: () => value,
set: (v: number) => {
if (!Number.isInteger(v) || v < min || v > max) {
throw new Error(`${key} 必须是 ${min}-${max} 的整数,收到: ${v}`);
}
value = v;
},
});
};
}
class User {
@validate(0, 120) age!: number;
}
运行结果
const u = new User();
u.age = 25; // ✅ 正常
console.log(u.age); // 25
u.age = 200; // ❌ 抛出 Error: age 必须是 0-120 的整数,收到: 200
注意:需在 tsconfig.json 中启用 "experimentalDecorators": true,否则装饰器语法报错。
风险点:类属性必须使用“明确赋值断言”(
!),否则 TypeScript 会报“未初始化”错误。成功要点:装饰器工厂可以轻松扩展多个校验规则(如邮箱格式、最小值等),代码复用性极佳。
测试建议
尝试赋 0、120、-1、3.14、'abc' 等边界值,确认只有整数范围校验通过。也可将装饰器应用于多个属性,验证独立性。
注意事项
属性装饰器不执行初始化逻辑,若类属性有默认值,需在 setter 中处理。装饰器只执行一次,但 getter/setter 每次访问都会触发。