什么是javascript装饰器_如何使用它增强类和函数？-js教程-PHP中文网

什么是javascript装饰器_如何使用它增强类和函数？

幻影之瞳

发布： 2025-12-20 12:13:02

原创

527人浏览过

JavaScript装饰器是声明式增强类及成员的语法糖，属TC39 Stage 3提案，需Babel或TypeScript编译；本质为接收target/propertyKey/descriptor（方法）或constructor（类）的函数，用于日志、校验、响应式等横切逻辑。

什么是javascript装饰器_如何使用它增强类和函数？

JavaScript 装饰器（Decorators）是一种用于**声明式地增强类、类方法、访问器或参数**的语法特性，目前处于 Stage 3 提案阶段（TC39），尚未被所有环境原生支持，需借助 Babel 或 TypeScript 编译使用。它不是运行时魔法，而是编译期对目标结构进行元编程改造的语法糖。

装饰器的核心作用

装饰器本质是**函数**，接收目标对象（类构造器、方法描述符等）作为参数，返回处理后的新定义（或 void）。它让开发者能以简洁、可复用的方式注入横切关注点，比如日志、权限校验、缓存、重试、响应式绑定等。

常见使用场景包括：

给类方法自动添加性能监控或错误捕获
为类属性标记响应式依赖（如 Vue 3 的 @Ref、@Watch）
在调用前统一校验参数或身份
冻结类实例、禁用构造器重复调用等约束逻辑

如何写一个基础方法装饰器

方法装饰器接收三个参数：target（原型对象）、propertyKey（方法名）、descriptor（属性描述符）。你可以修改 descriptor.value 来包装原函数。

立即学习“Java免费学习笔记（深入）”；

例如，实现一个简单的日志装饰器：

Phidata

Phidata是一个开源框架，可以快速构建和部署AI智能体应用

173

查看详情

function log(target, propertyKey, descriptor) {
  const original = descriptor.value;
  descriptor.value = function(...args) {
    console.log(`[LOG] 调用 ${String(propertyKey)}，参数：`, args);
    const result = original.apply(this, args);
    console.log(`[LOG] ${String(propertyKey)} 返回：`, result);
    return result;
  };
}

登录后复制

然后在类中使用：

class Calculator {
  @log
  add(a, b) {
    return a + b;
  }
}
const calc = new Calculator();
calc.add(2, 3); // 控制台输出调用与返回信息

登录后复制

如何写一个类装饰器

类装饰器接收一个参数：constructor（类本身），可返回新构造函数来替换原类。

例如，给类自动添加静态版本号和冻结实例：

function version(v) {
  return function<T extends { new (...args: any[]): {} }>(constructor: T) {
    constructor.version = v;
    return class extends constructor {
      constructor(...args: any[]) {
        super(...args);
        Object.freeze(this);
      }
    };
  };
}

@version('1.2.0')
class User {
  name: string;
  constructor(name: string) {
    this.name = name;
  }
}

console.log(User.version); // '1.2.0'
new User('Alice').name = 'Bob'; // 不会报错但无效（已冻结）

登录后复制

实际使用前要注意的关键点

装饰器目前还不是标准 JavaScript，直接在浏览器或 Node.js 中运行会报语法错误。必须通过工具链启用：

TypeScript：在 tsconfig.json 中开启 "experimentalDecorators": true 和 "emitDecoratorMetadata": true
Babel：安装 @babel/plugin-proposal-decorators，并在配置中启用（推荐使用 legacy: false 配合 proposal: "decorators-2023"）
装饰器执行顺序：类装饰器 → 属性/方法装饰器（从上到下）→ 方法 descriptor 修改 → 构造器执行
不能直接装饰普通函数（如 function foo() {}），仅支持类、类成员、参数（@param 需配合反射 API）