Typescript中什么是装饰器,它们可以应用于什么?
参考答案
定义
装饰器(Decorator)是一种声明式的特殊声明,以 @expression 形式写在类、方法、属性、访问器或参数上,运行时被调用以修改/增强被装饰的目标。TS 通过 experimentalDecorators 支持(旧版 stage-2 提案),属于编译期语法 + 运行时执行。
五种可应用位置
- 类装饰器
@Component({...}) class Foo {}→(target: Function) => void | Function - 方法装饰器 →
(target, propertyKey, descriptor) - 属性装饰器 →
(target, propertyKey) - 访问器装饰器(getter/setter)→ 同方法装饰器
- 参数装饰器(构造器参数或方法参数)→
(target, key, index)
示例
function log(target: any, key: string, desc: PropertyDescriptor) {
const origin = desc.value;
desc.value = function (...args: any[]) {
console.log(`call ${key}`, args);
return origin.apply(this, args);
};
}
class Service {
@log
fetch(id: number) { return id; }
}
执行顺序
- 同一目标多个装饰器:从下往上(靠近声明的先执行)。
- 不同层级:参数 → 方法/属性 → 类,即"内层先、外层后"。
- 属性装饰器无法修改初始值(只能记录元数据),要改值需配合
Object.defineProperty或类装饰器。
使用场景
- 依赖注入(Angular/NestJS 的
@Injectable、@Controller)。 - 路由/ORM 映射(
@Get('/users')、TypeORM 的@Entity/@Column)。 - 校验(class-validator 的
@IsEmail())。 - 日志、性能计时、缓存、节流防抖。
- 权限控制(
@Roles('admin'))。 - 需要元数据时配合
reflect-metadata的Reflect.defineMetadata。
注意
- 装饰器只在类声明时执行一次,不是每次调用都执行(方法装饰器是在定义时包装)。
- 新版 TC39 装饰器(stage 3)API 与旧版不同(无 descriptor,用
addInitializer),需注意实现库的兼容性。 - 装饰器不能用于普通函数声明(只能类及其成员)。
- 过度使用会让代码"魔法化",调试困难。