装饰器通过修改类或方法行为提升代码可维护性，如用LogCreation记录类创建时间，AddTimestamp添加实例属性，MeasureTime统计方法耗时，PreventConcurrent防止异步重复执行。
JavaScript 装饰器是一种特殊类型的声明，可以被附加到类、方法、访问器、属性或参数上，用来修改或增强它们的行为。虽然目前装饰器仍处于提案阶段（Stage 3），但在 TypeScript 和一些现代框架如 Angular、NestJS 中已被广泛使用。通过实际例子，我们可以更好地理解如何在类与方法中应用装饰器。
类装饰器：控制类的创建与行为
类装饰器接收构造函数作为唯一参数，可用于监视、拦截或替换类定义。
例如，我们想记录某个类的实例化时间：
function LogCreation(target: Function) {
console.log(`${target.name} 类在 ${new Date().toISOString()} 被创建`);
}
@LogCreation
class UserService {
getName() {
return "John Doe";
}
}
// 输出：UserService 类在 2025-04-05T10:00:00.000Z 被创建
也可以返回一个新的构造函数来扩展原始类的功能：
function AddTimestamp(constructor: T) { return cl ass extends constructor { createdAt = new Date(); }; }
@AddTimestamp class Post { title: string; constructor(title: string) { this.title = title; } }
const post = new Post("Hello World"); console.log(post.createdAt); // 输出当前时间
ass extends constructor {
createdAt = new Date();
};
}
方法装饰器：监控与增强方法调用
方法装饰器应用于类的方法，接收三个参数：目标对象、成员名、成员的属性描述符。
常见用途包括日志记录、性能监控和权限检查。
比如添加一个耗时统计装饰器：
function MeasureTime(target: any, propertyKey: string, descriptor: PropertyDescriptor) {
const originalMethod = descriptor.value;
descriptor.value = function (...args: any[]) {
console.time(propertyKey);
const result = originalMethod.apply(this, args);
console.timeEnd(propertyKey);
return result;
};
return descriptor;
}
class DataProcessor {
@MeasureTime
process(data: number[]) {
return data.map(x => x * 2).filter(x => x > 10);
}
}
const processor = new DataProcessor();
processor.process([1, 5, 6, 8, 12]); // 控制台输出类似：process: 0.2ms
另一个实用场景是防止重复调用异步操作：
function PreventConcurrent(target: any, propertyKey: string, descriptor: PropertyDescriptor) {
const originalMethod = descriptor.value;
let isRunning = false;
descriptor.value = async function (...args: any[]) {
if (isRunning) {
console.warn(${propertyKey} 正在执行中，跳过本次调用);
return;
}
isRunning = true;
try {
return await originalMethod.apply(this, args);
} finally {
isRunning = false;
}
};
return descriptor;
}
属性装饰器与参数装饰器简要说明
属性装饰器用于监听属性的定义，常用于依赖注入系统。它接受两个参数：目标对象和属性名。
function InjectService(target: any, propertyKey: string) {
target[propertyKey] = new SomeService(); // 模拟注入
}
参数装饰器则作用于方法参数，可用于元数据标记，例如：
function Validate(target: any, methodName: string, paramIndex: number) {
Reflect.defineMetadata(`validate:${methodName}`, true, target.constructor);
}
这类功能通常结合 Reflect Metadata 实现更复杂的运行时类型系统。
基本上就这些核心实践。装饰器让代码更具声明性，把横切关注点（如日志、校验、缓存）从主逻辑中剥离。只要注意兼容性和性能影响，就能在项目中有效提升可维护性。
