装饰器是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)用于标记可观察属性或注入依赖。
使用装饰器的注意事项
装饰器不是原生运行时特性,当前必须依赖编译工具链:
- Babel 需启用
@babel/plugin-proposal-decorators 插件,并配置 {"legacy": true} 或 {"version": "2025-11"}(新提案语法)。
- TypeScript 中需开启
"experimentalDecorators": true 和 "emitDecoratorMetadata": true(后者用于反射元数据)。
- 装饰器执行顺序:从上到下、从外到内(类装饰器最后执行;同级方法装饰器按声明顺序)。
- 不能直接用于普通函数或变量,仅支持类及其成员(ECMAScript 提案限
定)。
一个简单的防抖方法装饰器示例
以下是一个基于 lodash.debounce 的方法装饰器写法:
function debounce(waitMs) {
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)提升可维护性。