build(www): 添加 Drone CI 流水线配置

- 新增 .drone.yml 文件用于定义 CI/CD 流程 - 配置了基于 Docker 的部署步骤 - 设置了工作区和卷映射以支持持久化数据 - 添加了构建准备阶段和 Docker 部署阶段 - 定义了环境变量和代理设置 - 配置了 artifacts 目录的处理逻辑 - 添加了 timezone 映射以确保时间同步 - 设置了 docker.sock 映射以支持 Docker in Docker
2025-11-01 13:36:00 +08:00
commit 22e48d9558
272 changed files with 44007 additions and 0 deletions
--- a/blogs/frontend/promise.md
+++ b/blogs/frontend/promise.md
@@ -0,0 +1,315 @@
+---
+title: Promise使用之道
+date: 2022-01-25
+sidebar: 'auto'
+tags:
+ - Promise
+categories:
+ - JavaScript
+---
+## 1 Promise的理解和使用
+
+Promise 是异步编程的一种解决方案，主要用来解决**回调地狱**的问题，可以有效的减少回调嵌套。真正解决需要配合async/await
+
+*   抽象表达:
+    *   Promise 是一门新的技术(ES6 规范)
+    *   Promise 是 JS 中进行异步编程的新解决方案
+        > 备注：旧方案是单纯使用回调函数
+
+*   具体表达:
+    *   从语法上来说: Promise 是一个构造函数
+    *   从功能上来说: promise 对象用来封装一个异步操作并可以获取其成功/ 失败的结果值
+
+### 1.1 Promise的状态
+
+*   实例对象中的一个属性 『PromiseState』
+    *   pending 未决定的
+    *   resolved / fullfilled 成功
+    *   rejected 失败
+
+> 说明: 只有两种状态(resovled||rejectd), 且一个 promise 对象只能改变一次 无论变为成功还是失败, 都会有一个结果数据 成功的结果数据一般称为 value, 失败的结果数据一般称为 reason
+
+![Promise基本流程](https://note.youdao.com/yws/api/personal/file/425CC8D89ECD4EC7BB575F64D2DF0350?method=download\&shareKey=676e11a6f1f8ba3398ab1321c3007fe0)
+
+### 1.2 Promise的基本使用
+
+1.  延时器的使用来启动异步任务
+    ```js
+    const timeOutPromise = new Promise((resolve, reject) => {
+        console.log("启动异步任务");
+        setTimeout(() => {
+            console.log("异步任务开始执行...");
+            let time = Date.now();
+            if( time % 2 === 0 ){
+                console.log("执行成功了");
+                resolve(time);
+            }else{
+                console.log("执行失败了");
+                reject(time);
+            }
+        }, 1000);
+    });
+    // 异步任务的执行结果处理
+    timeOutPromise
+        .then(value => console.log(value),
+              reason => console.log(reason))
+    ```
+2.  ajax请求使用Promise
+    ```js
+    // 获取原生ajax对象
+    const XMLHttpRequest = require('xmlhttprequest').XMLHttpRequest;
+    const ajaxPromise = new Promise((resolve, reject) => {
+        // 获取原生请求对象
+        const xhr = new XMLHttpRequest();
+        xhr.open('GET', 'http://aopt.xyz:3366/test/hello');
+        // 响应结果的回调函数
+        xhr.onreadystatechange = () => {
+            if( xhr.readyState !== 4 ) return;
+            // 将请求的数据通过解构赋值
+            const {status, responseText} = xhr;
+            if( status >= 200 && status < 300 ){
+                resolve(responseText);
+            }else{
+                reject(status);
+            }
+        }
+        // 将请求进行发送
+        xhr.send();
+    })
+
+    ajaxPromise
+        .then(value => console.log(value),
+              reason => console.log(reason))
+    ```
+3.  fs模块使用Promise
+    ```js
+    const fs = require('fs')
+    // 创建一个用来读取文件的函数
+    const fsPromise = path => {
+        return new Promise((resolve, reject) => {
+            // 进行文件的读取, 第二个参数是以错误为优先的回调函数
+            fs.readFile(path, (err, data) => {
+                if( err ) reject(err);
+                resolve(data);
+            })
+        })
+    }
+
+    fsPromise('./笔记.md')
+        .then(value => console.log(value.toString()),
+              reason => console.log(reason))
+    ```
+4.  异常穿透的Promise
+    ```js
+    fsPromise('./aksdhfa.txt')
+        .then()
+        // 捕捉该Promise中出现的异常, 然后进行处理
+        .catch(err => console.log("这是catch捕捉到的异常"))
+    ```
+5.  `util.promisify`方法, 直接将函数变成Promise封装的方式
+    ```js
+    const util = require('util')
+    const fs = require('fs')
+    let creatorFsPromise = util.promisify(fs.readFile);
+    creatorFsPromise('./笔记.md')
+        .then(value => console.log("这是promisify方法"))
+    ```
+
+## 2 为什么使用Promise
+
+1.  指定回调函数的方式更加灵活
+    *   旧的: 必须在启动异步任务前指定
+    *   promise: 启动异步任务 => 返回promie对象 => 给promise对象绑定回调函 数(甚至可以在异步任务结束后指定/多个)
+2.  持链式调用, 可以解决回调地狱问题
+    1.  什么是回调地狱
+        *   回调函数嵌套调用, 外部回调函数异步执行的结果是嵌套的回调执行的条件
+    2.  回调地狱的缺点?
+        *   不便于阅读 不便于异常处理
+    3.  解决方案?
+        *   promise 链式调用,用来解决回调地狱问题，但是只是简单的改变格式，并没有彻底解决上面的问题真正要解决上述问题，一定要利用promise再加上await和async关键字实现异步传同步
+    4.  终极解决方案?
+        *   promise + async/await
+
+## 3 Promise中常用的API
+
+### 3.1 Promise 构造函数: Promise(excutor){}
+
+(1) executor 函数: 执行器 (resolve, reject) => {}
+
+(2) resolve 函数: 内部定义成功时我们调用的函数 value => {}
+
+(3) reject 函数: 内部定义失败时我们调用的函数 reason => {}
+
+> 说明: executor 会在 Promise 内部立即同步调用,异步操作在执行器中执行,换话说Promise支持同步也支持异步操作
+
+### 3.2 Promise.prototype.then 方法: (onResolved, onRejected) => {}
+
+(1) onResolved 函数: 成功的回调函数 (value) => {}
+
+(2) onRejected 函数: 失败的回调函数 (reason) => {}
+
+> 说明: 指定用于得到成功 value 的成功回调和用于得到失败 reason 的失败回调 返回一个新的 promise 对象
+
+### 3.3 Promise.prototype.catch 方法: (onRejected) => {}
+
+(1) onRejected 函数: 失败的回调函数 (reason) => {}
+
+> 说明: then()的语法糖, 相当于: then(undefined, onRejected)
+
+(2) 异常穿透使用: 当运行到最后, 没被处理的所有异常错误都会进入这个方法的回调函数中
+
+### 3.4 Promise.resolve 方法: (value) => {}
+
+(1) value: 成功的数据或 promise 对象
+
+> 说明: 返回一个成功/失败的 promise 对象,直接改变promise状态
+
+### 3.5 Promise.reject 方法: (reason) => {}
+
+(1) reason: 失败的原因
+
+> 说明: 返回一个失败的 promise 对象,直接改变promise状态
+
+### 3.6 Promise.all 方法: (promises) => {}
+
+promises: 包含 n 个 promise 的数组
+
+> 说明: 返回一个新的 promise, 只有所有的 promise 都成功才成功, 只要有一 个失败了就直接失败
+
+```js
+let p1 = new Promise((resolve, reject) => { resolve('成功');  })
+let p2 = Promise.reject('错误错误错误');
+let p3 = Promise.resolve('也是成功')
+const result = Promise.all([p1, p2, p3]);
+console.log(result);
+```
+
+### 3.7 Promise.race 方法: (promises) => {}
+
+(1) promises: 包含 n 个 promise 的数组
+
+> 说明: 返回一个新的 promise, 第一个完成的 promise 的结果状态就是最终的结果状态, 如p1延时,开启了异步,内部正常是同步进行,所以p2>p3>p1,结果是P2
+
+```js
+let p1 = new Promise((resolve, reject) => {
+    setTimeout(() => {
+        resolve('OK');
+    }, 1000);
+})
+let p2 = Promise.resolve('Success');
+let p3 = Promise.resolve('Oh Yeah');
+//调用
+const result = Promise.race([p1, p2, p3]);
+(result.then(value => console.log(value));
+```
+
+## 4 Promise的几个关键问题
+
+### 4.1 如何改变 promise 的状态?
+
+(1) resolve(value): 如果当前是 pending 就会变为 resolved
+
+(2) reject(reason): 如果当前是 pending 就会变为 rejected
+
+(3) 抛出异常: 如果当前是 pending 就会变为 rejected
+
+### 4.2 一个 promise 指定多个成功/失败回调函数, 都会调用吗?
+
+当 promise 改变为对应状态时都会调用, 改变状态后, 多个回调函数都会调用, 并不会自动停止(多次调用then)
+
+### 4.3 改变 promise 状态和指定回调函数谁先谁后?
+
+(1) 都有可能, 正常情况下是先指定回调再改变状态, 但也可以先改状态再指定回调
+
+*   先指定回调再改变状态(`异步`): 先指定回调--> 再改变状态 -->改变状态后才进入异步队列执行回调函数
+*   先改状态再指定回调(`同步`): 改变状态 -->指定回调 并马上执行回调
+
+(2) 如何先改状态再指定回调? -->注意: 指定并不是执行
+
+ ① 在执行器中直接调用 resolve()/reject() -->即,不使用定时器等方法,执行器内直接同步操作
+
+ ② 延迟更长时间才调用 then() -->即,在`.then()`这个方法外再包一层例如延时器这种方法
+
+(3) 什么时候才能得到数据?
+
+ ① 如果先指定的回调, 那当状态发生改变时, 回调函数就会调用, 得到数据(异步)
+
+ ② 如果先改变的状态, 那当指定回调时, 回调函数就会调用, 得到数据(同步)
+
+(4) 理解--结合源码
+
+*   源码中,promise的状态是通过一个`默认为padding`的变量进行判断,所以当你`resolve/reject`延时(异步导致当then加载时,状态还未修改)后,这时直接进行`p.then()`会发现,目前状态还是进行中,所以只是这样导致只有同步操作才能成功.
+*   所以promise将传入的`回调函数`拷贝到promise对象实例上,然后在`resolve/reject`的执行过程中再进行调用,达到异步的目的
+*   具体代码实现看下方自定义promise
+
+### 4.4 promise.then()返回的新 promise 的结果状态由什么决定?
+
+(1) 简单表达: 由 then()指定的回调函数执行的结果决定
+
+(2) 详细表达:
+
+ ① 如果抛出异常, 新 promise 变为 rejected, reason 为抛出的异常
+
+ ② 如果返回的是非 promise 的任意值, 新 promise 变为 resolved, value 为返回的值
+
+ ③ 如果返回的是另一个新 promise, 此 promise 的结果就会成为新 promise 的结果
+
+### 4.5 promise 如何串连多个操作任务?
+
+(1) promise 的 then()返回一个新的 promise, 可以开成 then()的链式调用
+
+(2) 通过 then 的链式调用串连多个同步/异步任务,这样就能用then()将多个同步或异步操作串联成一个同步队列
+
+### 4.6 promise 异常传透?
+
+*   当使用 promise 的 then 链式调用时, 可以在最后指定失败的回调
+*   前面任何操作出了异常, 都会传到最后失败的回调中处理
+
+### 4.7 中断 promise 链?
+
+(1) 当使用 promise 的 then 链式调用时, 在中间中断, 不再调用后面的回调函数
+
+(2) 办法: 在回调函数中返回一个 pendding 状态的promise 对象
+
+```js
+let p = new Promise((resolve, reject) => {setTimeout(() => { resolve('OK');}, 1000);});
+
+p.then(value => {return new Promise(() => {});})//有且只有这一个方式
+    .then(value => { console.log(222);})
+    .then(value => { console.log(333);})
+    .catch(reason => {console.warn(reason);});
+```
+
+## 5 Promise + async + await
+
+1.  Promise ==> 异步
+
+2.  await ==> 异步转同步
+
+    1.  await 可以理解为是async wait的简写。await 必须出现在 async 函数内部，不能单独使用。
+    2.  await 后面可以跟任何的JS 表达式。虽然说 await 可以等很多类型的东西，但是它最主要的意图是用来等待 Promise 对象的状态被 resolved。如果await的是 promise对象会造成异步函数停止执行并且等待 promise 的解决,如果等的是正常的表达式则立即执行
+
+3.  async ==> 同步转异步
+
+    1.  方法体内部的某个表达式使用await修饰，那么这个方法体所属方法必须要用async修饰所以使用awit方法会自动升级为异步方法
+
+4.  mdn文档
+
+    *   [async](https://developer.mozilla.org/zh-CN/docs/Web/JavaScript/Reference/Statements/async_function)
+    *   [await](https://developer.mozilla.org/zh-CN/docs/Web/JavaScript/Reference/Operators/await)
+
+### 5.1 async函数
+
+1.  函数的返回值为 promise 对象
+2.  promise 对象的结果由 async 函数执行的返回值决定
+
+### 5.2 await表达式
+
+1.  await 右侧的表达式一般为 promise 对象, 但也可以是其它的值
+2.  如果表达式是 promise 对象, await 返回的是 promise 成功的值
+3.  如果表达式是其它值, 直接将此值作为 await 的返回值
+
+### 5.3 注意
+
+1.  await 必须写在 async 函数中, 但 async 函数中可以没有 await
+2.  如果 await 的 promise 失败了, 就会抛出异常, 需要通过 try...catch 捕获处理
--- a/blogs/frontend/typescript.md
+++ b/blogs/frontend/typescript.md
@@ -0,0 +1,284 @@
+---
+title: Typescript-基本语法
+date: 2022-02-27
+sidebar: 'auto'
+tags:
+ - TypeScript
+categories:
+ - JavaScript
+---
+## 1 Typescript安装
+- 安装命令: `npm i typescript -g`
+- 使用Typescript命令查看安装的版本号: `tsc -v`
+- 生成配置文件tsconfig.json: `tsc -init`
+
+### 1.1 tsc常用编译参数
+
+|<div style="width:120px">编译参数</div>|说明|
+|:--|:--|
+|--help | 显示帮助信息
+|--module | 载入扩展模块
+|--target | 设置 ECMA 版本
+|--declaration | 额外生成一个 .d.ts 扩展名的文件。`tsc ts-hw.ts --declaration` 以上命令会生成 ts-hw.d.ts、ts-hw.js 两个文件。
+|--removeComments | 删除文件的注释
+|--out | 编译多个文件并合并到一个输出的文件
+|--sourcemap | 生成一个 sourcemap (.map) 文件。sourcemap 是一个存储源代码与编译代码对应位置映射的信息文件。
+|--module noImplicitAny | 在表达式和声明上有隐含的 any 类型时报错
+--watch | 在监视模式下运行编译器。会监视输出文件，在它们改变时重新编译。
+
+
+## 2 Typescript基础类型
+
+|<div style="width:80px">数据类型</div>|<div style="width:80px">关键字</div>|描述|
+|:--|:--|:--|
+|任意类型|	any	| 声明为 any 的变量可以赋予任意类型的值。`let x:any`
+|数字类型|	number	|双精度 64 位浮点值。它可以用来表示整数和分数。`let num:number`
+|字符串类型|	string|一个字符系列，使用单引号（'）或双引号（"）来表示字符串类型。反引号（`）来定义多行文本和内嵌表达式。
+|布尔类型|	boolean	|表示逻辑值：true 和 false。
+|数组类型	|无	|声明变量为数组。`let arr:number[];let arr:Array<number>;// 泛型定义`
+|元组	|无	|元组类型用来表示已知元素数量和类型的数组，各元素的类型不必相同，对应位置的类型需要相同。`let x:[string, number] = ['string', 15]`
+|枚举|	enum	| 枚举类型用于定义数值集合。`enum Color{Red, Green};// 没有赋值默认从0开始`
+|void|	void	|用于标识方法返回值的类型，表示该方法没有返回值。`function hello(): void {}`
+|null	|null	|表示对象值缺失。
+|undefined|	undefined	|用于初始化变量为一个未定义的值
+|never	|never	|never 是其它类型（包括 null 和 undefined）的子类型，代表从不会出现的值。
+
+
+## 3 Typescript接口
+
+### 3.1 属性类型接口
+```ts
+// 对传入对象的属性约束, 以下是一个约束属性接口
+interface User{
+    username: string;
+    password?: string; // 可选传递
+}
+
+function save(user:User):void{
+    console.log(user)
+}
+
+let info = {
+    username: "张三",
+    password: "qwe123",
+    age: 15     // 额外传递的参数
+}
+// 传递一个自定义对象的参数需要有必选参数, 其他的属性不会进行检查
+save(info)
+// 如果直接进行对象传递那么会进行类型的检查
+save({
+    username: "张三",
+    password: "qwe123"
+})
+```
+
+### 3.2 函数类型接口
+```ts
+// 定义一个函数类型的接口
+interface encrypt {
+    (key: string, value: string): string;
+}
+// 既然类型定义为接口类型(参数列表可以不用写类型), 那么就得符合接口的类型
+let md5: encrypt = (key, value): string => {
+    return `MD5://${key}.${value}`
+}
+// 发现类型换成any也行, 因为any能接受所有类型
+let sha1: encrypt = (key: any, value: any): any => {
+    return `SHA1://${key}.${value}`
+}
+console.log(md5("qwe", "123"))
+// 但是发现还是会被类型约束, 所以就算定义了any类型也没有什么起效
+// sha1(123, 564) // 错误写法
+console.log(sha1("asd", "zxc"))
+```
+
+### 3.3 可索引型接口
+```ts
+// 可索引型数组接口, []中为number, 返回值为string
+interface CustomArr {
+    [index: number]: string;
+}
+let arr: CustomArr = ['111', '222']
+console.log(arr[1])
+
+// 可索引型对象接口, key为string, value为string
+interface CustomObj {
+    [index: string]: string;
+}
+let obj: CustomObj = {name: 'zhang', sex: '男'}
+console.log(obj['name'])
+console.log(obj.sex)
+```
+
+### 3.44 类类型接口
+与面向对象语言相似(Java)
+
+## 4 Typescript泛型
+软件工程中，我们不仅要创建一致的定义良好的API，同时也要考虑可重用性。 组件不仅能够支持当前的数据类型，同时也能支持未来的数据类型，这在创建大型系统时为你提供了十分灵活的功能。在像C#和Java这样的语言中，可以使用泛型来创建可重用的组件，一个组件可以支持多种类型的数据，这样用户就可以以自己的数据类型来使用组件。
+
+通俗理解：泛型就是解决类、接口、方法的复用性、以及对不特定数据类型的支持。
+
+## 5 Typescript装饰器
+> 对修饰器的实验支持功能在将来的版本中可能更改。
+>
+> 在"tsconfig"或"jsconfig"中设置"experimentalDecorators"选项以删除此警告。
+>
+> "experimentalDecorators":true // 启用对ES7装饰器的实验性支持。
+
+装饰器是一种特殊类型的声明，它能够被附加到类、方法、属性或参数上，可以修改类的行为，通俗的讲装饰器就是一个方法，可以注入到类、方法、属性或参数上来扩展类、方法、属性或参数的功能。常见的装饰器有：类装饰器、方法装饰器、属性装饰器、参数装饰器。
+
+装饰器的写法：普通装饰器（无法传参）、装饰器工厂（可传参），装饰器是过去几年中JS最大的成就之一，已是ES7的标准特性之一。
+
+### 5.1 类修饰器
+ 类装饰器: 普通装饰器(无法传参)
+    ```ts
+    function logClass(param: any){
+        // 获取到的参数是该实例化对象
+        console.log(param)
+        // 在这里可以对实例话对象进行动态挂载数据
+        param.prototype.apiUrl = 'http://localhost'
+        param.prototype.run = () => {
+            console.log("动态扩展的run方法")
+        }
+    }
+    
+    // 该类装饰器不能传递参数
+    @logClass
+    class HttpClient {}
+    
+    let http:any = new HttpClient()
+    console.log(http.apiUrl)
+    http.run()
+    ```
+
+ 类装饰器: 装饰器工厂(可传参)
+    ```ts
+    function logClass(...params: string[]) {
+        return function(target: any) {
+            // target是当前类的对象
+            console.log(target)
+            // params是装饰器中传递的参数, 可以定义多个参数
+            target.prototype.apiUrl = params[0] + params[1]
+        }
+    }
+    
+    @logClass('http://localhost', "/api/users")
+    class HttpClient{}
+    
+    let http: any = new HttpClient()
+    console.log(http.apiUrl)
+    ```
+
+### 5.2 属性修饰器
+属性装饰器会被应用到属性描述上，可以用来监视、修改或者替换属性的值。
+
+属性装饰器会在运行时传入下列2个参数：
+- 对于静态成员来说是类的构造函数，对于实例成员是类的原型对象。
+- 成员的名字。
+```ts
+function logProperty(params: string) {
+    return function(target: any, attr: any) {
+        // 装饰器传递的参数
+        console.log(params)
+        // 给类的属性挂载数据
+        target[attr] = params
+    }
+}
+
+class HttpClient {
+    @logProperty("http://localhost")
+    apiUrl: string | undefined;
+
+    getApiUrl() {
+        console.log(this.apiUrl)
+    }
+}
+
+let http: HttpClient = new HttpClient()
+http.getApiUrl()
+```
+
+### 5.3 方法修饰器
+方法装饰器会被应用到方法描述上，可以用来监视、修改或者替换方法定义。
+
+方法装饰器会在运行时传入下列3个参数：
+- 对于静态成员来说是类的构造函数，对于实例成员是类的原型对象。
+- 成员的名字。
+- 成员的属性描述符。
+```ts
+class HttpClient {
+    public url: any | undefined;
+
+    @get("http://localhost")
+    getData() {
+        console.log(this.url);
+    }
+}
+
+function get(param: string){
+    return function(target: any, methodName: any, desc: any){
+        console.log(target)
+        console.log(methodName)
+        console.log(desc)
+        // 可以通过类的原型对象target对该实例进行数据挂载
+        target.url = param
+        target.run = function(){
+            console.log('run')
+        }
+        // 可以修改装饰器所放置方法的实现, 以下的代码就是获取该方法的内容
+        console.log(desc.value)
+    }
+}
+
+let http: any = new HttpClient()
+http.getData()
+http.run()
+```
+
+### 5.4 参数修饰器
+参数装饰器表达式会在运行时当作函数被调用，可以使用参数装饰器为类的原型增加一些元素数据 ，传入下列3个参数：
+- 对于静态成员来说是类的构造函数，对于实例成员是类的原型对象。
+- 方法的名字。
+- 参数在函数参数列表中的索引。
+```ts
+function logParams(params: any) {
+    return function (target: any, methodName: any, paramsIndex: any) {
+        console.log(target);
+        console.log(methodName);
+        console.log(paramsIndex);
+        target.apiUrl = params;
+    }
+}
+
+class HttpClient {
+    getData(name: string, @logParams("10086") uuid: any) {
+        console.log(uuid);
+    }
+}
+
+let http: any = new HttpClient();
+http.getData('zhang', 123456);
+console.log(http.apiUrl);
+```
+
+### 5.5 修饰器的执行顺序
+装饰器执行顺序：++属性 > 方法 > 方法参数 > 类++
+
+如果有多个**同类型**的装饰器, 那么会++从后往前执行++
+
+## 6 Typescript模块化
+模块化的好处
+- 防止命名冲突
+- 代码复用
+- 高维护性
+
+模块功能主要由两个命令构成：export 和 import。
+- export 命令用于规定模块的对外接口
+- import 命令用于输入其它模块提供的功能
+
+## 7 Typescript命名空间
+命名空间：在代码量较大的情况下，为了避免各种变量命名相冲突，可将相似功能的函数、类、接口等放置到命名空间内，同Java的包、.Net的命名空间一样，TypeScript的命名空间可以将代码包裹起来，只对外暴露需要在外部访问的对象，命名空间内的对象通过export关键字对外暴露。
+
+命名空间和模块的区别：
+- 命名空间：内部模块，主要用于组织代码，避免命名冲突。
+- 模块：ts的外部模块的简称，侧重代码的复用，一个模块里可能会有多个命名空间。