装饰器通过修改类或方法行为提升代码可维护性,如用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 被创建
也可以返回一个新的构造函数来扩展原始类的功能:
立即学习“Java免费学习笔记(深入)”;
function AddTimestamp(constructor: T) { return class 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); // 输出当前时间
方法装饰器:监控与增强方法调用
方法装饰器应用于类的方法,接收三个参数:目标对象、成员名、成员的属性描述符。
常见用途包括日志记录、性能监控和权限检查。
比如添加一个耗时统计装饰器:
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 实现更复杂的运行时类型系统。
基本上就这些核心实践。装饰器让代码更具声明性,把横切关注点(如日志、校验、缓存)从主逻辑中剥离。只要注意兼容性和性能影响,就能在项目中有效提升可维护性。










