也许跟大家不太一样,我是这么用TypeScript来写前端的

前端Q

共 7834字，需浏览 16分钟

· 2023-08-24

点击上方前端Q ，关注公众号

回复加群，加入前端Q技术交流群

一、当前一些写前端的骚操作

先罗列一下见到过的一些写法吧：）

1. interface(或Type)一把梭

掘金上很多文章，一提到 TypeScript，那不得先用 interface 或者 type 来声明个数据结构吗？像这样：

      
      type User = {
    nickname: string
    avatar?: string
    age: number
}

interface User {
    nickname: string
    avatar?: string
    age: number
}

然后其他方法限制下入参类型，搞定，我掌握了 TypeScript 了，工资不得给我涨3000？？？

这里说明一下，我司 不允许 直接使用 interface type 来定义非装饰器参数和配置性参数之外其他 任何数据类型。

2. 类型体操整花活

要么把属性整成只读了，要么猪狗类型联合了，要么猪尾巴搞丢了，要么牛真的会吹牛逼了。

类型体操确实玩出了很多花活。昨天说过了：TypeScript最好玩的就是类型体操, 也恰好是最不应该出现的东西

3. `hook` 的无限神话

不知道什么时候开始，hook 越来越流行。听说不会写 hook 的前端程序员，已经算不上高阶程序员了，不 use 点啥都展示不出牛逼的水平。

4. `axios` 拦截大法好

随便搜索一下 axios 的文章，没有 拦截器 这个关键词的文章都算不上 axios 的高端用法了。

二、我们一些不太一样的前端骚操作

昨天的文章有提到一些关于在前端使用 装饰器 来实现一些基于配置的需求实现，今天其实想重点聊一聊如何在前端优雅的面向对象。

写过 Java、SpringBoot、JPA 等代码的后端程序员应该非常熟悉的一些概念：

抽象：万物都可抽象成相关的类和对象
面向对象：继承、封装、多态等特性的面向对象设计思维
切面：没有什么是切一刀解决不了的，如果一刀不行，那就多来几刀。
注解：没有什么常量是不能使用注解来配置的，也没有什么注解是切面想切还能躲得掉的
反射：没有什么是暴力拿取会失败的，即使失败也没有异常是丢不出来的
实体：没有什么是不能抽象到实体上的，万物皆唯一。
很多：还有很多，以上描述比较主观和随意。

于是我们开始把后端思维往前端来一个个的转移：）

1. 抽象和面向对象

与后端的交互数据对象、请求的API接口都给抽象到具体的类上去，于是有了：

Service API请求类

      
      abstract class AbstractService{
    // 实现一个抽象属性 让子类们实现
    abstract baseUrl!: string
    
    // 再实现一些通用的 如增删改查之类的网络请求
    // save()
    
    // getDetail()
    
    // deleteById()
    
    // select()
    
    // page()
    
    // disabled()
    
    // ......
}

Entity 数据实体基类

      
      abstract class AbstractBaseEntity<S extends AbstractService> {
    abstract service!: AbstractService

    // 任何数据都是唯一的 ID
    id!: number
    
    // 再来实现一些数据实体的更新和删除方法
    save(){
        await service.save(this.toJson())
        Notify.success("新增成功")
    }
    
    delete(){
        service.deleteById(this.id)
        Notify.success("删除成功")
    }
    
    async validate(scene: EntityScene):Promise<void>{
        return new Promise((resolve,reject)=>{
            // 多场景的话 可以Switch
            if(...){
                Notify.error("XXX校验失败")
                reject();
            }
            resove();
        })
    }
    // ......
}

子类的实现：）

      
      class UserEntity extends AbstractUserEntity<UserService>{
    service = new UserService()
    
    nickname!: string
    age!: number
    avatar?: string
    
    // 用户是否成年人
    isAdult(): boolean{
        return this.age >= 18
    }
    
    async validate(scene: EntityScene): Promise<void> {
        return new Promise((resove,reject)=>{
            if(!this.isAdult()){
                Notify.error("用户未成年, 请确认年龄")
                reject();
            }
            await super.validate(scene)
        })
    }
    
}

View 视图调用

      
      <template>
    <el-input v-model="user.nickname"/>
    <el-button @click="onUserSave()">创建用户</el-button>
</template>
<script setup lang="ts">
const user = ref(new UserEntity())
async function onUserSave(){
    await user.validate(EntityScene.SAVE);
    await user.save()
}
</script>

2. 装饰器/切面/反射

装饰器部分的话，昨天的文章有提到一些了，今天主要所说反射和切面部分。

在 TypeScript 中，其实装饰器本身就可以理解为一个切面了，这里与 Java 中还是有很多不同的，但概念和思维上是基本一致的。

反射 Reflect 是 TypeScript 中比较坑的一个存在，目前主要是依赖 reflect-metadata 这个第三方库来实现，将一些元数据存储到 metadata 中，在需要使用的时候通过反射的方式来获取。可以参考这篇文章：TypeScript 中的元数据以及 reflect-metadata 实现原理分析[1]

在实际使用中，我们早前用的是 class-transformer 这个库，之前我对这个库的评价应该是非常高的: “如果没有 class-transformer 这个库， TypeScript 狗都不写。”

确实很棒的一个库，但是在后来，我们写了个通用的内部框架，为了适配 微信小程序端 以及 uniapp 端，再加上有一些特殊的业务功能以及 class-transfromer 的写法和命名方式我个人不太喜欢的种种原因，我们放弃了这个库，但我们仿照了它的思想重新实现了一个内部使用的库，做了一些功能的阉割和新特性的添加。

核心功能的一些说明

通过反射进行数据转换

如将后端API返回的数据按照前端的数据结构强制进行转换, 当后端数据返回乱七八糟的时候，保证前端数据在使用中不会出现任何问题，如下 demo

      
      class UserEntity {
 @Type(String) phone!: string;
 @Type(RoleEntity) roleInfo!: RoleEntity:
 @Type(DeptEntity) @List @Default([]) deptInfoList!: DeptEntity[]
 @Type(Boolean) @Default(false) isDisabled!: boolean
}