TypeScript 是一种面向对象的编程语言，它提供了许多实用的特性，其中最常用的特性之一就是装饰器。在本文中，我们将学习 TypeScript 中的装饰器注解，包括如何定义、使用和自定义一个装饰器。
什么是装饰器？
装饰器是一种特殊的语法，它可以用来在类、方法、属性和参数前添加元数据。元数据通常是一些键值对，用于描述类或者类的某个部分的特性。在 TypeScript 中，元数据以注解的形式呈现，这就是我们所说的装饰器注解。
装饰器注解在很多方面都很有用，它可以用来对代码进行注释、扩展等操作。例如，我们可以用装饰器注解来声明一个类是单例模式，或者添加一些验证逻辑等。
如何定义装饰器？
在 TypeScript 中，我们可以使用 @ 符号来定义装饰器。一个装饰器通常是一个函数或者一个类，它接受一个或多个参数，这些参数是元数据的键值对。当我们在类、方法、属性或者参数前使用装饰器时，它会被解释成一个函数调用。
下面是一个装饰器的基本语法：
function myDecorator(target: any, key: string, descriptor: PropertyDescriptor): void {
// 在这里添加装饰器逻辑
}装饰器函数接收三个参数，分别是：
target：被装饰的对象，可以是类、属性、方法或者参数key：被装饰对象的键值（属性名、方法名等）descriptor：该对象的描述符，包括它的值、getter、setter 等
如何使用装饰器？
下面我们将学习如何在 TypeScript 中使用装饰器注解。
1. 类装饰器
类装饰器可以用来装饰一个类，它会影响到这个类所有实例的行为。一个类装饰器的例子如下：
-- -------------------- ---- -------
-------- ---------------------- --------- -
--- --------- ----
----- -------------- - ----------------- -
-- ----------- -
-------- - --- ---------------------
-
------ ---------
-
------------------------ - ----------------------
------ ---------------
-
----------
----- ------- -
------------- -
-------------------- --- ---- ----------
-
-
----- ---- - --- ---------- -- ------- --- ---- -------
----- ---- - --- ---------- -- ------- ------
---------------- --- ------ -- ----在这个例子中，@singleton 装饰器被用来将 MyClass 类转化成一个单例模式类。在装饰器函数中，我们定义了变量 instance 来存储该类的唯一实例。newConstructor 函数被用来扩展 MyClass 的构造函数，它会判断是否已经创建了 MyClass 的实例。如果没有，就会创建一个新的实例并返回。否则，就会直接返回 instance。
2. 属性装饰器
属性装饰器可以用来装饰一个类的属性，它可以改变一个属性的行为或者添加额外的逻辑。一个属性装饰器的例子如下：
-- -------------------- ---- -------
-------- ----------------- ---- ---- ------- -
--- ----- - ------------
----- ------ - ---------- -
------ ------
-
----- ------ - ------------------ ------- -
----- - -----------------------
-
----------------------------- ---- -
---- -------
---- -------
----------- -----
------------- ----
---
-
----- ------- -
----------
------- ------ -------
----------------- ------- -
---------- - -----
-
--- ------ -
------ -----------
-
--- ----------- ------- -
---------- - ------
-
-
----- --- - --- ----------------------
---------------------- -- ----------
-------- - -------------
---------------------- -- ----------在这个例子中，@uppercase 装饰器被用来将 MyClass 的 _name 属性转化成大写形式。在装饰器函数中，我们添加了 getter 和 setter 函数来处理 _name 属性。在 setter 函数中，我们将属性值转化成大写形式并存储在 value 变量中。然后，我们使用 Object.defineProperty 方法来将getter和setter函数添加到_name属性描述符中。
3. 方法装饰器
方法装饰器可以用来装饰一个类的方法。它可以改变该方法的行为或者添加额外的逻辑。一个方法装饰器的例子如下：
-- -------------------- ---- -------
-------- ----------- ---- ---- ------- ----------- ------------------- -
----- -------------- - -----------------
---------------- - ----------------- -
------------------- ---------
------ -------------------------- ------
-
------ -----------
-
----- ------- -
----
----------- ------- -
------------------ ----------
-
-
----- --- - --- ----------
------------------------ -- ----- ------------- ----------在这个例子中，@log 装饰器被用来在调用 greet 方法时添加额外的日志信息。在装饰器函数中，我们通过修改 descriptor.value 函数来添加额外的逻辑，例如添加日志信息。需要注意的是，我们返回了修改后的函数描述符，因为我们想使用修改后的函数实现原本的行为。
如何自定义一个装饰器？
如果 TypeScript 提供的装饰器不能满足您的需求，您还可以自定义一个装饰器。一个自定义装饰器的例子如下：
-- -------------------- ---- -------
-------- -------------------------- ---- ---- ------- ----------- ------------------- --------- ---- -
------------------------ ----------
-
----- ------- -
--------------------- -------- ------- --
----------- ------- -
------------------ ----------
-
-在这个例子中，@myCustomDecoractor 装饰器被用来添加元数据。在装饰器函数中，我们添加了一个参数 metadata 来接收装饰器传入的元数据。在 @myCustomDecoractor 装饰器中，我们传入一个对象 { message: 'Hello' } 作为元数据。
总结
在本文中，我们学习了 TypeScript 中的装饰器注解，包括如何定义、使用和自定义一个装饰器。我们了解了装饰器注解的基本语法和如何使用它们来装饰一个类、属性、方法或者参数。希望本文可以帮助您更加熟悉 TypeScript 中的装饰器，并在实际开发中灵活运用。
来源：JavaScript中文网 ，转载请注明来源 https://www.javascriptcn.com/post/647b3992968c7c53b06c072d