Typescript装饰器：功能与使用场景

TypeScript 装饰器（Decorators）是一种特殊类型的声明，它可以附加到类、属性、方法或参数上。装饰器提供了一种简单的方法来扩展和修改类、方法或属性的功能。它们在 TypeScript 中扮演着非常重要的角色，尤其是在框架和库的开发中。

功能

1. 类装饰器：用于修改类的定义，例如添加新的方法或属性。
2. 属性装饰器：用于修改类的属性，例如添加验证器或默认值。
3. 方法装饰器：用于修改类的方法，例如添加日志记录或性能监控。
4. 参数装饰器：用于修改方法的参数，例如添加默认值或验证器。
5. 返回值装饰器：用于修改方法的返回值，例如添加缓存或错误处理。
6. 类方法装饰器：用于修改类的方法，例如添加依赖注入。
7. 类构造器装饰器：用于修改类的构造函数，例如添加参数验证。

使用场景

1. 依赖注入：装饰器可以用于实现依赖注入，使得类之间的依赖关系更加明确和易于管理。
2. 日志记录：装饰器可以用于在方法执行前后添加日志记录，以便于调试和性能监控。
3. 验证：装饰器可以用于对类的属性或方法参数进行验证，确保数据的有效性。
4. 缓存：装饰器可以用于对类的方法返回值进行缓存，以提高性能。
5. 权限控制：装饰器可以用于检查用户是否具有执行特定方法的权限。
6. 事务管理：装饰器可以用于在方法执行前后开启和提交事务，以确保数据的一致性。

示例

以下是一个简单的 TypeScript 装饰器示例，用于验证类的属性：

function validate(target: Object, key: string) {
  const originalValue = target[key];

  Object.defineProperty(target, key, {
    get() {
      return originalValue;
    },
    set(value) {
      if (typeof value !== 'string' || value.length < 3) {
        throw new Error(`Invalid value for ${key}: ${value}`);
      }
      originalValue = value;
    },
  });
}

class User {
  @validate
  name: string;
}

const user = new User();
user.name = 'John'; // 正常设置值
user.name = 123; // 抛出错误：Invalid value for name: 123

在这个示例中，我们定义了一个名为 validate 的属性装饰器，用于验证 User 类的 name 属性是否为字符串且长度至少为 3。当尝试设置无效值时，将抛出错误。