es6 class 本身不支持原生装饰器,需通过 typescript 或 babel 启用 stage 3 装饰器提案;装饰器是运行于类定义时的函数,用于标记并增强类、方法或属性,参数依类型而异,执行顺序为从上到下、从右到左。

ES6 的 class 本身不支持原生装饰器,但通过 TypeScript 或 Babel(配合提案阶段的装饰器语法)可以使用 Stage 3 装饰器提案(目前为 tc39/proposal-decorators v2)来扩展类和方法功能。关键在于:装饰器是函数,用于“标记”并增强类、属性或方法,运行时机在类定义时(而非实例化时)。
装饰器怎么写?基础形式
装饰器本质是接收目标、名称、描述符等参数的函数:
- 类装饰器:接收
constructor(类本身)作为唯一参数 - 方法/访问器装饰器:接收
target(原型或构造函数)、propertyKey(方法名)、descriptor(属性描述符) - 属性装饰器(非标准,Babel/TS 支持):接收
target和propertyKey,但无 descriptor(因属性尚未定义)
例如一个日志装饰器:
function log(target, propertyKey, descriptor) {
const original = descriptor.value;
descriptor.value = function(...args) {
console.log(`调用 ${propertyKey},参数:`, args);
return original.apply(this, args);
};
return descriptor;
}
class MathUtils {
@log
add(a, b) {
return a + b;
}
}
如何启用装饰器支持
纯浏览器环境默认不支持。需借助工具链:
Java项目代码review工具。分析Git变更+完整调用链路上下文,推断业务需求,进行多维度评分和分类汇总,生成完整PRD文档。包含细粒度Java代码审查清单(Null安全、异常处理、Streams、并发、equals/hashCode、资源管理、API设计、性能、MyBatis/ORM、事务边界、SQL/DD...
-
TypeScript:在
tsconfig.json中开启"experimentalDecorators": true和"emitDecoratorMetadata": true(后者用于反射元数据) -
Babel:安装
@babel/plugin-proposal-decorators,并在.babelrc中配置:{"plugins": [["@babel/plugin-proposal-decorators", {"version": "2023-11"}]]} - 注意:装饰器执行顺序是**从上到下、从右到左**(类装饰器最后执行,方法装饰器按声明顺序)
实用扩展场景
装饰器适合封装横切关注点:
-
权限控制:在方法执行前检查
this.role或 token,不满足则 throw - 防抖/节流:包装方法,限制高频调用(如搜索框输入)
- 自动绑定 this:避免在 React 类组件中手动 bind,装饰器可直接改写 descriptor.value 为箭头函数行为
-
序列化/校验:结合
reflect-metadata,在属性上标记类型或规则,运行时读取并校验
示例(自动绑定):
function autobind(target, propertyKey, descriptor) {
const fn = descriptor.value;
return {
configurable: true,
enumerable: false,
get() {
const boundFn = fn.bind(this);
Object.defineProperty(this, propertyKey, { value: boundFn });
return boundFn;
}
};
}
注意事项和限制
装饰器不是魔法,有明确边界:
- 不能修改类的继承关系(比如不能把 class A 变成 extends B)
- 方法装饰器中修改
descriptor.value是安全的;但直接替换整个 descriptor 需谨慎处理writable、enumerable等字段 - 属性装饰器无法直接拦截赋值(ES6 不提供属性 setter 装饰),需配合
Object.defineProperty或 Proxy 手动实现响应式 - 装饰器函数本身应是纯函数(无副作用),否则可能引发不可预期的初始化问题
Java免费学习笔记:立即使用
解锁 Java 大师之旅:从入门到精通的终极指南










