装饰器是JavaScript中用于增强类、方法等行为的语法糖,处于Stage 3提案阶段,需Babel或TypeScript支持;它以@开头,通过包装方式实现日志、权限校验、缓存等功能,不改变原代码结构。

装饰器(Decorator)是 JavaScript 中一种用于修改类、方法、属性或参数行为的语法糖,目前处于 Stage 3 提案阶段,需借助 Babel 或 TypeScript 等工具支持才能在实际项目中使用。它本身不改变原有代码结构,而是通过“包装”方式增强功能,类似 Python 的 @decorator 语法。
如何在 JavaScript 中使用装饰器
装饰器本质是一个函数,接收目标对象、成员名、属性描述符等参数,并可返回新的描述符或修改原行为。使用时以 @ 符号开头,放在被修饰项上方。
- 类装饰器:作用于整个类,接收类构造函数作为参数。可用于日志、注入、元数据注册等。
- 方法装饰器:作用于类方法,接收类原型、方法名、属性描述符。常用于权限校验、缓存、防抖、性能监控。
- 访问器装饰器:类似方法装饰器,但针对 getter/setter。
- 属性装饰器:作用于类字段(非初始化值),接收类原型和属性名,常配合 Reflect Metadata API 存储类型/校验信息。
- 参数装饰器:作用于函数参数,接收类原型、方法名、参数索引,多用于依赖注入框架(如 Angular)。
装饰器适用的典型场景
装饰器适合那些需要横切关注点(cross-cutting concerns)且不希望侵入业务逻辑的场景:
- 权限控制:在方法执行前检查用户角色,无权限则抛出错误或跳过执行。
- 请求拦截与日志:自动记录接口调用时间、参数、耗时,便于调试与监控。
- 缓存管理:对纯函数式方法添加缓存逻辑,避免重复计算(如基于参数生成 key 并查 Map)。
- 数据验证:结合属性装饰器 + 运行时校验库,在 setter 或方法入参时触发规则检查。
- 状态绑定与响应式增强:在框架中(如 MobX、Angular)用于标记可观察属性或注入依赖。
使用装饰器的注意事项
装饰器不是原生运行时特性,当前必须依赖编译工具链:
立即学习“Java免费学习笔记(深入)”;
- Babel 需启用
@babel/plugin-proposal-decorators插件,并配置{"legacy": true}或{"version": "2023-11"}(新提案语法)。 - TypeScript 中需开启
"experimentalDecorators": true和"emitDecoratorMetadata": true(后者用于反射元数据)。 - 装饰器执行顺序:从上到下、从外到内(类装饰器最后执行;同级方法装饰器按声明顺序)。
- 不能直接用于普通函数或变量,仅支持类及其成员(ECMAScript 提案限定)。
一个简单的防抖方法装饰器示例
以下是一个基于 lodash.debounce 的方法装饰器写法:
return function(target, key, descriptor) {
const originalMethod = descriptor.value;
descriptor.value = _.debounce(originalMethod, waitMs);
return descriptor;
};
}
然后在类中使用:
class SearchBox {@debounce(300)
onInput(value) {
console.log('search:', value);
}
}
不复杂但容易忽略细节:装饰器函数本身要返回符合规范的描述符,否则可能破坏原有方法行为;生产环境建议搭配类型系统(如 TypeScript)提升可维护性。











