JS装饰器编程_Decorator应用指南-js教程-PHP中文网

JS装饰器编程_Decorator应用指南

幻影之瞳

发布： 2025-11-14 22:23:02

原创

973人浏览过

装饰器是一种函数，用于在不修改原始代码的情况下增强类、方法、属性或参数的行为。通过@符号应用于目标声明，运行时接收元信息并返回修改后的描述符或对象。类装饰器可修改类定义，如冻结实例或添加元数据；方法装饰器通过 descriptor 控制方法行为，实现只读、日志、性能监控等；属性和参数装饰器主要用于元数据标注，常用于依赖注入和参数标记，需配合 Reflect Metadata 使用。尽管 JavaScript 装饰器尚处 Stage 2，TypeScript 和框架如 Angular、NestJS 已广泛支持，提供声明式编程能力，提升代码解耦与复用性。

js装饰器编程_decorator应用指南

装饰器（Decorator）是一种特殊类型的声明，可以被附加到类声明、方法、访问器、属性或参数上，用于在不修改原始代码的情况下增强或修改其行为。JavaScript 装饰器目前处于提案阶段（Stage 2），但在 TypeScript 和部分现代框架（如 Angular、NestJS）中已被广泛使用。

什么是装饰器？

装饰器本质上是一个函数，它会在运行时被调用，并传入目标对象的相关元信息，比如类的构造函数、方法描述符、属性名等。通过返回新的描述符或修改原对象，实现对目标功能的扩展或控制。

语法使用 @ 符号开头，紧跟装饰器函数名，写在目标声明之前：

@logMethod
class User {
@readonly
getName() { return "Tom"; }
}

类装饰器：控制类的行为

类装饰器接收一个参数——类的构造函数，可用于监听、替换或修改类定义。

常见用途包括：

自动注册类到全局容器（如依赖注入系统）
冻结类实例防止扩展
添加静态属性或方法

示例：为类添加元数据和实例锁定

function sealed(constructor: Function) {
  Object.seal(constructor);
  Object.seal(constructor.prototype);
}

@sealed
class Person {
  name = "Alice";
}

方法装饰器：拦截与增强方法调用

方法装饰器应用于类的方法，接收三个参数：target（原型对象或构造函数）、propertyKey（方法名）、descriptor（属性描述符）。

通过修改 descriptor，可以实现只读、日志记录、性能监控等功能。

示例：实现方法只读

豆包AI编程

豆包推出的AI编程助手

483

查看详情

function readonly(target: any, propertyKey: string, descriptor: PropertyDescriptor) {
  descriptor.writable = false;
}

class MathLib {
  @readonly
  add(a: number, b: number) { return a + b; }
}

尝试重写 add 方法将抛出错误（非严格模式下静默失败）。

进阶用法：记录方法执行时间

function log(target: any, propertyKey: string, descriptor: PropertyDescriptor) {
  const original = descriptor.value;
  descriptor.value = function (...args: any[]) {
    console.log(`Call: ${propertyKey} with`, args);
    const start = Date.now();
    const result = original.apply(this, args);
    console.log(`Time: ${Date.now() - start}ms`);
    return result;
  };
  return descriptor;
}

属性与参数装饰器：细粒度控制

属性装饰器用于监听或修改类中的属性声明，接收 target 和属性名。常用于依赖注入或字段验证。

参数装饰器则作用于方法参数，可用于标记参数用途或收集元数据。

示例：参数装饰器标记请求上下文

function ReqParam(target: any, methodName: string, paramIndex: number) {
console.log(`Parameter at index ${paramIndex} in ${methodName}`);
}

class Controller {
getUser(@ReqParam id: number) {}
}

注意：属性和参数装饰器不能修改属性值或参数本身，主要用于元数据标注，通常配合 Reflect Metadata 使用。

基本上就这些。装饰器提供了一种声明式编程方式，让逻辑解耦更清晰。虽然原生 JavaScript 尚未正式支持，但借助 Babel 或 TypeScript 已可实战使用。合理设计装饰器能显著提升代码可维护性和复用性。

以上就是JS装饰器编程_Decorator应用指南的详细内容，更多请关注php中文网其它相关文章！