Javascript如何实现装饰器_如何动态扩展功能？_技术教程

JavaScript装饰器是Stage 3提案，作为语法糖在类定义阶段动态增强类、方法等；支持类、方法、属性装饰器，常用于日志、错误重试、权限控制等横切关注点。

JavaScript 中的装饰器（Decorator）目前仍是 Stage 3 提案，尚未正式进入标准，但可通过 Babel（配合 @babel/plugin-proposal-decorators）或 TypeScript 启用。它本质是一种语法糖，用于在类、方法、访问器或属性声明时，以声明式方式“包裹”或“增强”目标行为——也就是动态扩展功能的核心机制。

装饰器的基本形态：函数接收目标信息

装饰器必须是函数，它会在定义时被调用，并接收不同参数，取决于装饰位置：

类装饰器：接收构造函数（target）
方法/访问器装饰器：接收类原型（target）、方法名（propertyKey）、属性描述符（descriptor）
属性装饰器（仅 TS 或 Babel 模拟）：接收类构造函数和属性名（不直接操作 descriptor，需配合 Object.defineProperty 或元数据实现）

关键点：装饰器执行时机是**类定义阶段**（非实例化时），因此适合做静态增强、元数据收集、方法重写等。

用方法装饰器实现日志与性能监控

这是最典型的动态扩展场景：不修改原方法逻辑，只在外层添加横切关注点。

function log(target, propertyKey, descriptor) {
  const original = descriptor.value;
  descriptor.value = function(...args) {
    console.log(`[LOG] 调用 ${propertyKey}，参数：`, args);
    const start = performance.now();
    const result = original.apply(this, args);
    const end = performance.now();
    console.log(`[PERF] ${propertyKey} 执行耗时：${end - start}ms`);
    return result;
  };
}

使用方式：

class Calculator {
  @log
  add(a, b) {
    return a + b;
  }
}

调用 new Calculator().add(2, 3) 会自动打印日志和耗时——功能动态注入，原方法零侵入。

用类装饰器统一处理错误与重试

适用于需要为整组方法添加容错能力的场景，比如 API 客户端类。

function withErrorBoundary(retry = 2) {
  return function(target) {
    Object.getOwnPropertyNames(target.prototype).forEach(key => {
      const desc = Object.getOwnPropertyDescriptor(target.prototype, key);
      if (desc && typeof desc.value === 'function' && !key.startsWith('_')) {
        const original = desc.value;
        desc.value = async function(...args) {
          for (let i = 0; i <= retry; i++) {
            try {
              return await original.apply(this, args);
            } catch (err) {
              if (i === retry) throw err;
              console.warn(`第 ${i + 1} 次失败，${1000 * (i + 1)}ms 后重试...`);
              await new Promise(r => setTimeout(r, 1000 * (i + 1)));
            }
          }
        };
        Object.defineProperty(target.prototype, key, desc);
      }
    });
  };
}

这样，只需 @withErrorBoundary(1) 就能让类中所有公开方法具备自动重试能力。

结合元数据实现权限控制（需 Reflect Metadata）

要真正实现“动态扩展”，常需配合 reflect-metadata 存储配置，再在运行时读取并决策。

import 'reflect-metadata';
function requireRole(role) {
return function(target, propertyKey, descriptor) {
Reflect.defineMetadata('role:required', role, target, propertyKey);
const original = descriptor.value;
descriptor.value = function(...args) {
const userRole = this.currentUser?.role || 'guest';
const required = Reflect.getMetadata('role:required', target, propertyKey);
if (userRole !== required) {
throw new Error(权限不足：需要 ${required} 角色);
}
return original.apply(this, args);
};
};
}
// 使用
class AdminPanel {
@requireRole('admin')
deleteUser(id) { / ... / }
}

权限规则在装饰时声明，执行时动态校验——逻辑解耦，易于维护和替换策略。