JavaScript装饰器是Stage 3提案，作为语法糖在类定义阶段动态增强类、方法等；支持类、方法、属性装饰器，常用于日志、错误重试、权限控制等横切关注点。
JavaScript 中的装饰器（Decorator）目前仍是 Stage 3 提案，尚未正式进入标准，但可通过 Babel（配合 @babel/plugin-proposal-decorators）或 TypeScript 启用。它本质是一种语法糖，用于在类、方法、访问器或属性声明时，以声明式方式“包裹”或“增强”目标行为——也就是动态扩展功能的核心机制。
装饰器的基本形态：函数接收目标信息
装饰器必须是函数，它会在定义时被调用，并接收不同参数，取决于装饰位置：
- 类装饰器：接收构造函数（
target） - 方法/访问器装饰器：接收类原型（
target）、方法名（propertyKey）、属性描述符（descriptor） - 属性装饰器（仅 TS 或 Babel 模拟）：接收类构造函数和属性名（不直接操作 descriptor，需配合
Object.defineProperty或元数据实现）
关键点：装饰器执行时机是**类定义阶段**（非实例化时），因此适合做静态增强、元数据收集、方法重写等。
用方法装饰器实现日志与性能监控
这是最典型的动态扩展场景：不修改原方法逻辑，只在外层添加横切关注点。
立即学习“Java免费学习笔记（深入）”；
function log(target, propertyKey, descriptor) {
const original = descriptor.value;
descriptor.value = function(...args) {
console.log(`[LOG] 调用 ${propertyKey}，参数：`, args);
const start = performance.now();
const result = original.apply(this, args);
const end = performance.now();
console.log(`[PERF] ${propertyKey} 执行耗时：${end - start}ms`);
return result;
};
}使用方式：
class Calculator {
@log
add(a, b) {
return a + b;
}
}调用 new Calculator().add(2, 3) 会自动打印日志和耗时——功能动态注入，原方法零侵入。
用类装饰器统一处理错误与重试
适用于需要为整组方法添加容错能力的场景，比如 API 客户端类。
function withErrorBoundary(retry = 2) {
return function(target) {
Object.getOwnPropertyNames(target.prototype).forEach(key => {
const desc = Object.getOwnPropertyDescriptor(target.prototype, key);
if (desc && typeof desc.value === 'function' && !key.startsWith('_')) {
const original = desc.value;
desc.value = async function(...args) {
for (let i = 0; i <= retry; i++) {
try {
return await original.apply(this, args);
} catch (err) {
if (i === retry) throw err;
console.warn(`第 ${i + 1} 次失败，${1000 * (i + 1)}ms 后重试...`);
await new Promise(r => setTimeout(r, 1000 * (i + 1)));
}
}
};
Object.defineProperty(target.prototype, key, desc);
}
});
};
}这样，只需 @withErrorBoundary(1) 就能让类中所有公开方法具备自动重试能力。
结合元数据实现权限控制（需 Reflect Metadata）
要真正实现“动态扩展”，常需配合 reflect-metadata 存储配置，再在运行时读取并决策。
import 'reflect-metadata';
<p>function requireRole(role) {
return function(target, propertyKey, descriptor) {
Reflect.defineMetadata('role:required', role, target, propertyKey);
const original = descriptor.value;
descriptor.value = function(...args) {
const userRole = this.currentUser?.role || 'guest';
const required = Reflect.getMetadata('role:required', target, propertyKey);
if (userRole !== required) {
throw new Error(<code>权限不足：需要 ${required} 角色</code>);
}
return original.apply(this, args);
};
};
}</p><p>// 使用
class AdminPanel {
@requireRole('admin')
deleteUser(id) { /<em> ... </em>/ }
}权限规则在装饰时声明，执行时动态校验——逻辑解耦，易于维护和替换策略。
