JavaScript装饰器是用于修改或增强函数、类等行为的语法糖,非原生标准但被TS和Babel广泛支持;以@开头,本质是接收target、propertyKey、descriptor的高阶函数,可拦截并增强方法逻辑。
JavaScript 装饰器(Decorator)是一种用于**修改或增强函数、类、类方法、访问器等行为的语法糖**,它本身不是原生 JavaScript 标准(截至 ECMAScript 2025,仍处于 Stage 3 提案阶段),但已被 TypeScript 和主流构建工具(如 Babel)广泛支持。它的核心思想是:**用一个函数去“包装”另一个函数或类成员,从而在不修改原始代码的前提下,注入额外逻辑(如日志、权限校验、缓存、重试等)**。
装饰器以 @ 符号开头,写在被修饰项的上一行。它本质是一个高阶函数,接收目标对象、属性名、属性描述符等参数,并可返回新的描述符来改变行为。
(target, propertyKey, descriptor)
descriptor.value 是原始方法函数,替换它就能拦截调用experimentalDecorators 编译选项装饰器最实用的地方,是把横切关注点(cross-cutting concerns)从业务逻辑中抽离出来。例如:
下面是一个简单但完整的函数装饰器,用于记录方法执行时间:
function log(target, propertyKey, descriptor) {
const originalMethod = descriptor.value;
descriptor.va
lue = function(...args) {
console.time(`[LOG] ${propertyKey}`);
const result = originalMethod.apply(this, args);
console.timeEnd(`[LOG] ${propertyKey}`);
return result;
};
return descriptor;
}
class Calculator {
@log
add(a, b) {
return a + b;
}
}
const calc = new Calculator();
calc.add(2, 3); // 控制台输出:[LOG] add: 0.123ms
装饰器虽简洁有力,但要注意实际落地条件:
function foo() {}),只适用于类、类成员、访问器、参数(实验性)@A @B @C 等价于 A(B(C(...)))
@log('debug')),要写成装饰器工厂:返回装饰器函数的函数