From d29722adfae28298ed96c1acfe6476522497620f Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=E4=B9=9D=E6=97=AC?= <1160030724@qq.com>
Date: Wed, 13 Sep 2023 06:23:29 +0000
Subject: [PATCH] feat: decorator

---
 docs/articles/TypeScript/README.md | 74 ++++++++++++++++++++++++++++++
 1 file changed, 74 insertions(+)

diff --git a/docs/articles/TypeScript/README.md b/docs/articles/TypeScript/README.md
index 6cb0ea4..1865a99 100644
--- a/docs/articles/TypeScript/README.md
+++ b/docs/articles/TypeScript/README.md
@@ -1053,6 +1053,80 @@ console.log(a, b, C);
 
 ## 装饰器
 
+装饰器（Decorator）是一种语法结构，用来在定义时修改类（class）的行为。
+
+在语法上，装饰器有如下几个特征。
+
+- （1）第一个字符（或者说前缀）是@，后面是一个表达式。
+- （2）@后面的表达式，必须是一个函数（或者执行后可以得到一个函数）。
+- （3）这个函数接受所修饰对象的一些相关值作为参数。
+- （4）这个函数要么不返回值，要么返回一个新对象取代所修饰的目标对象。
+
+装饰器一般只用来为类添加某种特定行为，用于给类本身或者类的方法、属性、访问器修改类的行为。
+
+### 装饰器的结构
+
+装饰器的函数类型定义如下：
+
+```ts
+type Decorator = (
+  value: DecoratedValue,
+  context: {
+    kind: string;
+    name: string | symbol;
+    addInitializer?(initializer: () => void): void;
+    static?: boolean;
+    private?: boolean;
+    access: {
+      get?(): unknown;
+      set?(value: unknown): void;
+    };
+  }
+) => void | ReplacementValue;
+```
+
+上面代码中，`Decorator` 是装饰器的类型定义。它是一个函数，使用时会接收到 `value` 和 `context` 两个参数。
+
+- `value`：所装饰的对象。
+- `context`：上下文对象，TypeScript 提供一个原生接口 `ClassMethodDecoratorContext`，描述这个对象
+
+```ts
+function decorator(value: any, context: ClassMethodDecoratorContext) {
+  // ...
+}
+```
+
+上面是一个装饰器函数，其中第二个参数 `context` 的类型就可以写成 `ClassMethodDecoratorContext`。
+
+`context` 对象的属性，根据所装饰对象的不同而不同，其中只有两个属性（`kind` 和 `name`）是必有的，其他都是可选的。
+
+- （1）`kind`：字符串，表示所装饰对象的类型，可能取以下的值。
+  'class'
+  'method'
+  'getter'
+  'setter'
+  'field'
+  'accessor'
+  这表示一共有六种类型的装饰器。
+
+- （2）`name`：字符串或者 Symbol 值，所装饰对象的名字，比如类名、属性名等。
+
+- （3）`addInitializer()`：函数，用来添加类的初始化逻辑。以前，这些逻辑通常放在构造函数里面，对方法进行初始化，现在改成以函数形式传入 `addInitializer()`方法。注意，`addInitializer()`没有返回值。
+
+- （4）`private`：布尔值，表示所装饰的对象是否为类的私有成员。
+
+- （5）`static`：布尔值，表示所装饰的对象是否为类的静态成员。
+
+- （6）`access`：一个对象，包含了某个值的 `get` 和 `set` 方法。
+
+### 装饰类
+
+### 装饰类的方法
+
+### 装饰类的属性
+
+### 装饰 getter、setter
+
 ## 其他
 
 ### 定义 window