TypeScript深入浅出，出不去也行

4xi
3,393 阅读26分钟

本文介绍了丰富的TS基础，能够满足你的日常开发需求。介绍了TS的基本的心智模型，帮你提升维护类型系统的能力。不会教你做类型体操，但是会告诉你如何利用别人的类型体操。

全是干货，渴了多喝点水，少写一点any，plz。🙏🙏🙏

基本类型介绍

1.Boolean，Number，String

声明:类型 = 类型对应变量

let flag:boolean = true
let age: number = 21;
let name: string = "shixin";

类型收敛——字面量类型

const flag: true = true;
const age: 21 = 21;
const name: 'shixin' = 'shixin';

2.undefined,null

在 TypeScript 中，null 与 undefined 类型都是有具体意义的类型。所以在默认情况下会被视作其他类型的子类型。

const data1: null = null;
const data2: undefined = undefined;
const data3: number = null; // That's OK
const data4: string = null; // That's OK

tsconfig strictNullChecks 配置项，会严格校验undefined和null。在该配置开启的环境下。undefined和null将不为其他类型的子类型

{
  "extends": "./tsconfig",
  "compilerOptions": {
    "strictNullChecks": true
  }
}

const data5: string = null; // error

3.联合类型

联合类型就是一个数组的可用的集合

let numOrStr :string|number = 1;
numOrStr = 'a' 
// ok

4.Array

在 TypeScript 中有两种方式来声明一个数组类型：

根据项目规范二选一（如果没有这个规范可以随便写）

const arr1: string[] = []; // 可以向数组内添加string类型的值
const arr2: Array<string> = [];

类型收敛——元组

场景1 基本类型元组定义

或许我们想定义一个数组来描述三家公司的名称（只有那三家，没有第四家，也不会只有两家），公司名是string，长度是3。但是我们声明string[]就是有问题的，因为他不够收敛。这个时候我们就可以使用元组了。

形式 [typeofmember1, typeofmember2,typeofmember3]

元组声明：[string,string,string]

const companyArr: [string,string,string] = ['公司n1', '公司n2', '公司n3'];

场景2 字面量类型元组定义

或许我们想定义一个数组来描述三家优秀公司的名称（NIO,小鹏,理想） 元组声明：['NIO','小鹏','理想']

const companyArr1: ['NIO','小鹏','理想'] = ['NIO','小鹏','理想'];

在这种情况下，对数组合法边界内的索引访问（即companyArr1[0]，companyArr1[1]，companyArr1[2]）将能够安全的返回我们理想中的哪三颗韭菜。

场景3 元组类型的 Rest 使用

或许我们想定义一个数组来定义一个人前三项分别为姓名，年龄，性别，后面可以添加若干项描述。这时候我们就可以引入Rest，语法如同js一样，三个点。 元组声明：[string,number,string,...string[]]

const Person: [string, number, string, ...string[]] = ['shixin', 22, '男', 'JV', '前端'];

但是问题来了， [string, number, string, ...string[]]未免太难理解了，我怎么知道哪一项代表了哪个信息。在TS4.0添加了具名元组。操作如下

const Person: [name:string, age:number,sex:string,...desc:string[]] = ['shixin', 22, '男', 'JV', '前端'];

5.常用对象类型描述

对于上面的元组场景3（定义一个数组来定义一个人前三项分别为姓名，年龄，性别）毕竟不是我们的常规操作，更加常见的是我们通过定义一个对象来完成对于一个人的定义。那么如何描述一个对象呢？

内联注解

我们可以如同基本类型一样直接在声明后面添加对象的类型描述

const shixin: { name: string; age: number; sex: string; desc: string[] } = {
    name: 'shixin',
    age: 22,
    sex: '男',
    desc: ['JV', '前端']
};

接口 interface

或通过interface来声明一个类型变量，在变量内进行对象的类型描述

interface IPerion {
    name: string;
    age: number;
    sex: string;
    desc: string[];
}

const shixin: IPerion = {
    name: 'shixin',
    age: 22,
    sex: '男',
    desc: ['JV', '前端']
};

这样声明的好处，最直接的就是可以复用，这对于我们维护和统一类型起源非常有帮助。

import { type IPerion } from 'xxx';

const zhang3: IPerion = {
    name: 'zhang3',
    age: 20,
    sex: '男',
    desc: ['xx', 'xx']
};

object、Object 以及 { }

Object用于描述一个对象，就是万物皆为对象的那个对象。在js中他包含了原始的功能，比如谁都有的toString。也正因为如此，这个属性其实并不好用。甚至有点像any。

let data1: Object = 'a'; // That's OK
let data2: Object = 1;// That's OK
let data3: Object = () => {};// That's OK

为了解决上面这个不好用的Object，在(typescript2.2)[www.typescriptlang.org/docs/handbo…] 引入了object type以表示不含原始类型（number，string，symbol等等）的object类型

const data1:object = 42; // Error
const data2:object = 'string'; // Error
const data3:object = false; // Error
const data4:object = undefined; // Error
const data5:object = { prop: 0 }; // OK

{}，一个空对象。你可以在该类型初始化的时候赋予各种各样的值，如同上面的第一个Object。但是在赋值的时候却比较麻烦。

const data1: {} = { foo: 1 }; // OK
data1.baz = 2;// Error

或许这样看起来并不常见，那么这个呢。

const obj = {};

事实上，这种定义的方式会讲{}推导为变量obj的类型。在javascript时期，这行代码随处可见。以至于在ts的代码中，依然会有非常多的这种写法，从而出现了下面这些代码.

const obj = {};
// 添加一个属性
obj.foo = 1; //类型“{}”上不存在属性“foo”。

// ⬇

/**
 * 给个初始值
 */
const obj1 = {
    foo: undefined
};
obj1.foo = 1; //不能将类型“1”分配给类型“undefined”。

// ⬇

/**
 * 分支1:给个初始类型undefined
 */
const obj: {
    foo: undefined | number;
} = {
    foo: undefined
};
obj.foo = 1;

/**
 * 分支2:把foo初始为-1
 */
const obj = {
    foo: -1
};
obj.foo = 1;

除了object之外，其他两种方式其实在初始化变量的时候非常的开放，对于类型基本没有收敛。所以我们更建议不要使用。而object实际上对变量的描述并不够细致，通常对于对象的创建，我们都能够预想到对象的内容，所以我们更倾向于使用interface接口来定义对象。

6.枚举

枚举的作用和定义形式像一个简单的键值一一对应的map

const CaseMap = {
    case1: 'Im case1',
    case2: 'Im case2'
};

enum CaseMap {
    case1 = 'Im case1',
    case2 = 'Im case2'
}

如果你没有声明枚举的值，它会默认使用数字枚举，并且从 0 开始。

const Direction = {
    Up: 0,
    Down: 1,
    Left: 2,
    Right: 3
};

enum Direction {
    Up,
    Down,
    Left,
    Right
}

如果你希望数字枚举从 1 开始，只需要在第一项枚举值声明起始值，那么接下来的项都会递增。

enum Direction {
    Up = 1,
    Down,
    Left,
    Right
}

对于枚举和对象的区别，也很简单，枚举是双向的，对象是单向映射的。原理很简单，我们将上面Direction编译为js，编译产物如下。

"use strict";
var Direction;
(function (Direction) {
    Direction[Direction["Up"] = 1] = "Up";
    Direction[Direction["Down"] = 2] = "Down";
    Direction[Direction["Left"] = 3] = "Left";
    Direction[Direction["Right"] = 4] = "Right";
})(Direction || (Direction = {}));

7.any,unknow,never

any,unknow

any,unknow基本可以用于声明所有的类型。在某些时候我们是需要这种能力的。例如系统日志对于error的catch。我们无法知道用户会在里面报什么类型的错误，也不知道谁会在代码里面throw 一个number，string，boolean类型的Error出来。对于这种完全无法预知的变量，我们就可以定义为any或者unknow。

那么都是可以用于声明任意类型，any和unknow的区别是什么呢。

unknow对应中文就是不知道的意思。既然是不知道，即使定义的时候，我们无法确定类型，所以使用的时候，我们也不能随意使用。

try{
	// xxxxx
} catch (e) {
    const num: number = e; //不能将类型“unknown”分配给类型“number”。
    if (isNumber(e)) {
        const num1: number = e; // e is number
    }
}

如上例子，我们需要通过一些判断手段，才能够对e进行使用。这样带来的好处就是，就算我不知道e是什么类型，但是只要通过一些必要的判断，我就能够安全的去操作他。坏处也显而易见，无论我做什么操作，我都需要进行判断，对类型进行过滤，才能够正常使用。

而any在这个demo的表现就相对的肆无忌惮。

try{
	// xxxxx
} catch (e:any) {
    const num: number = e; //ok
    const str: string = e; // ok
    if (isNumber(e)) {
        const num1: number = e; // e is number
    }
}

并且当我们定义了一个变量为any之后，他是具有传染性质的。any下面的所有属性都将是any。也就是在使用声明为any类型的变量时，该变量下面的所有属性都是危险的any。类型推断将会失效。

const data: any = 1;

any用的很爽，但是背后的代价就是把ts变成了anyScript，抛弃所有的类型推断，以让你的代码编辑看起来没有任何报错，表面风平浪静，背后暗流涌动。所以在我们想声明一个未知的catch error以及其他不知道的变量的时候，或许使用unknow更好，而现在unknow也成为了catch error的默认类型。

never

never代表着走不到头，无法执行下去的类型。抛开在类型体操的使用，在日常声明的使用场景多为 throw error。

function thouchError(): never {
    throw new Error();
    console.log("已经error咯，不能正常执行下面的内容了")
}

在实际应用中，我们通过if ... else ...在最后的else添加never的声明。这时候类型报错就可以帮助你处理干净所有的类型情况。例子如下：

const fun = (data: string | number) => {
    if (isString(data)) {
        data.charAt(1); //OK
    } else if (isNumber(data)) {
        data.toFixed(); //OK
    } else {
        const check: never = data;
        throw new Error(check);
    }
};

当data的类型情况多了一个boolean，ts就会推断报错。

const fun = (data: string | number | boolean) => {
    if (isString(data)) {
        data.charAt(1); //OK
    } else if (isNumber(data)) {
        data.toFixed(); //OK
    } else {
        const check: never = data; //不能将类型“boolean”分配给类型“never”。
        throw new Error(check);
    }
};

TS基本心智

类型上下文收敛和推断

类型推断就是TypeScript会根据上下文代码自动帮我们推算出变量或方法的类型。

当我们又一个函数名为 padLeft。如果参数 padding 是一个数字，我们就在 input 前面添加同等数量的空格，而如果 padding 是一个字符串，我们就直接添加到 input 前面。

function padLeft(padding: number | string, input: string) {
    return new Array(padding + 1).join(' ') + input; //运算符“+”不能应用于类型“string | number”和“number”。
}

报错的原因很简单，不能用string + 1（尽管在js中是可以的）,而变量padding是个number或者string，这样运算最后可能不是我们想要的结果。那么我们可以这样做

function padLeft(padding: number | string, input: string) {
  if (typeof padding === "number") {
    return new Array(padding + 1).join(" ") + input;
  }
  return padding + input;
}

而在这个过程中，我们其实对变量进行了几次收敛和推断。

  1. 通过typeof number 讲padding收敛为number
  2. 推断new Array(padding + 1)推断为数组
  3. 通过join推断new Array(padding + 1).join(" ")为字符串
  4. 顺利的让new Array(padding + 1).join(" ")可以和input相加
  5. 如果能走到最后的return padding + input 则说明typeof number为false。那么padding就是string
  6. string的padding可以顺利的和input相加

我们的类型系统就是如此保障我们的代码运行安全的。而对于类型上下文的收敛 ，这里借助(官方文档)[www.typescriptlang.org/docs/handbo…] 的demo举两个例子。

  • typeof
function printAll(strs: string | string[] | null) {
  if (typeof strs === "object") {
    for (const s of strs) {
		  // Object is possibly 'null'.
      console.log(s);
    }
  } else if (typeof strs === "string") {
    console.log(strs);
  } else {
    // do nothing
  }
}
  • in操作符
type Fish = { swim: () => void };
type Bird = { fly: () => void };
 
function move(animal: Fish | Bird) {
  if ("swim" in animal) {
    return animal.swim();
    // (parameter) animal: Fish
  }
 
  return animal.fly();
  // (parameter) animal: Bird
}
  • 穷举检查（参考上面的never相关demo）

对于这个类型的收敛，我们通常会用控制流分析来描述。通过上面的收敛方法，在if中进行对类型的控制，让一个变量可以被观察到不同的类型，作出不同的操作。除了上面的操作外，我们常常会自己去封装控制流的方法，也就是类型守卫。

类型守卫

为了拿到一个变量的string类型分支，我们常常会去做控制流分析。对于typeof string多次的使用，我们就会去封装一个isString的方法。以优雅我们的代码。但是当我们如下去完成一个isString。

const isString = (val: unknown): boolean => typeof val === 'string'

function padLeft(padding: number | string, input: string) {
    if (isString(padding)) {
        const str: string = padding; //不能将类型“string | number”分配给类型“string”。
    }
    // TODO xxx
}

我们会发现竟然报错了，但从我们主观类型推断的角度这padding确实已经是个string了。其实在typescript中，控制流分析是无法跨越上下文的。也就是我们padLeft函数中，我们无法从isString这个方法中捕获到类型的形象，我们只能知道他返回的是个boolean。为了解决这类问题，TS引入了 is 关键字。

语法： is 关键字 + 预期类型 我们只需要把 val is string替换掉boolean即可

const isString = (val: unknown): val is string => typeof val === 'string'

function padLeft(padding: number | string, input: string) {
    if (isString(padding)) {
        const str: string = padding; //不能将类型“string | number”分配给类型“string”。
    }
    // TODO xxx
}

同样的，vue3向外抛出的 (isRef)[vuejs.org/api/reactiv…] 方法的原理实现也添加了类型守卫

///core/packages/reactivity/src/ref.ts
export function isRef<T>(r: Ref<T> | unknown): r is Ref<T>
export function isRef(r: any): r is Ref {
  return !!(r && r.__v_isRef === true)
}

类型先行

当Typescript成为开发的附属品，javascripter会先将代码撸完，在开发过程中只写一些简单的类型声明。如果javascripter在逻辑编程上不关注类型编程。我们总能看到最后的代码成果会嵌套着大量的any , as等等不规范的操作。并不是any，as不能用。只是大多数人的使用场景，仅仅是因为改不动之前的数据结构了，或者同一个变量在许多的地方都有进行操作，而在操作的过程中，数据早就变了味（包括但是不限于可以往一个对象里来回赋值，string与number直接用+运算）。在这样的操作之后，类型系统将会变得更加的难以维护，甚至由于粗暴的as。让下一位开发者进入了一个对类型的错误判断，在这基础上进行了后续的操作。

为避免这种现象，我们可以提前进行基础类型的完成。

例如我们进行业务开发的时候的业务逻辑依赖于接口，我们就可以定义好接口的入参和出参数的interface。而这一份interface将成为我们对于这一块业务的开发基础类型。

interface IUserReq{
    userId:number
}

interface IUserRsp{
    userId:number,
    userName:string,
    QRCode:string,
    age:number
}

当我们将有如上的类型基准，那么接下来我们就可以从这一份类型基准，去进行开发，接下来的与user相关的代码类型，都可以是IUserRsp的衍生类型。

例如我们进行业务开发的时候的业务逻辑依赖于数据库，我们就可以定义好数据库的类型。那么我们在node开发的过程中，相关数据库数据操作数据的代码类型，都可以是数据库的衍生类型。

例如我们进行组件开发的时候，我们就可以定义好组件入参props的类型。那么我们在组件开发的过程中，相关props的组件变量类型，都可以是props的衍生类型。

类型约束和维护

不少开发者都称typescript是带着脚镣跳舞，脚镣就意味着约束。这句话的背后意思就是，我们在用TS的时候，其实是在一个约束的条件下，去完成我们的代码开发。而对于类型的约束，约束的程度就会直接反应到我们的项目代码上。

上面我们讲到组件开发以props作为类型的源头，那么以vue3组件开发为例子，我们会在setup语法糖下使用defineProps宏进行props声明。

const props = defineProps({
    title: {
        type: String,
    },
    UserList:{
        type:Array
    }
});

但是在这个props宏中，我们的声明收敛的其实非常烂，对于UserList，如果数据源来自我们上面的接口，那么这个Array是完全不满足的，我们从UserList上拿到项后直接进行取值，是毫无类型提示的，因为UserList此时是一个Array。

为了解决这个问题，vue3提供了PropType这个类型工具，以生成我们的props类型 。然后我们可以通过将type 通过as强行声明到我们通过PropType生成的props类型。也就是这样。

const props = defineProps({
    title: {
        type: String,
    },
    UserList:{
        type:Array as PropType<User[]>
    }
});

这样我们组件类型源头props才会被收敛，我们后面在基于props进行完成开发的时候，才会有类型保障。这就是类型收敛的意义。

tips：defineProps在vue3+TS可以 仅声明类型，配合withDefaults宏就可以达到上面的效果

export interface Props {
    title?: string;
    UserList?: User[];
}

const props = withDefaults(defineProps<Props>(), {
    title: '',
    UserList: () => []
});

泛形

上面我们通过PropType这个类型工具，生成了我们的props类型。而通过一个类型生成另一个目标类型，就是我们泛形的主要目的。以最简单的Array类型来说。我们就可以通过传入一个类型string，Array<string>来生成一个string类型的数组。

Array<T>类比为js，他可能是这样一段代码

function createArray(T) {
    const array = new Array()
    array.type = T;
    return array;
}

泛形可以类比为函数，通过一个入参，再通过函数内部的逻辑改造，我们就可以得到一个返回值。比如最简单的add函数。类型的实现与函数的实现，其实在使用上和定义上基本是一致的。区别就在于在类型上完成两数的加法具体实现可能不是那么容易。

const add = (num1, num2) => num1 + num2;
const res = add(1,1); // res = 2

type add<num1,num2> = /**一系列类型操作 */;
type res = add<1,2>; // type res = 3

于此相似的还有接口泛形，区别不大

interface IRes<T> {
    code: number;
    msg?: string;
    data: T;
}

函数泛形

我们有一个identity函数，将入参直接返回，那么我们将有如下实现。

function identity(arg) {
    return arg;
}

const res = identity(1); // res is any

我们可以确定的是，我们输入的是1，返回的就是1。但是结果是any，这在我们预期的类型推导层面是不合理的。所以我们需要函数泛形，函数泛形的作用就是为函数提供一个类型的入参，在整个函数体内都可以拿到这个类型入参。用于函数的内变量的声明，函数用于返回类型声明。

function identity<T>(arg): T {
    let data: T;
    return arg;
}

const res = identity<1>(1); // res 1

在泛形函数中，我们可以在变量处进行对泛形进行预赋值，将变量将来的值的类型赋值给泛形参数

function identity<T>(arg: T): T {
    let data: T;
    return arg;
}

const res = identity(1);// res 1 这样不用传入<1>这个类型参数

对于上面讲到的defineProp其实也是通过泛形参数实现的，实现如下。

function defineProps<TypeProps>(): Readonly<TypeProps>

于此相似的还有类泛形，作用同样是将泛形参数提供给类，在类里面可以进行使用该参数。

类型关键字

为了实现理想的类型约束和维护，我们就会使用到类型关键字，他可以帮助我们进行简单的类型转换，类似于js原生提供的api，比如array会有length属性可以拿到数组长度，Object.keys可以拿到一个对象的key组成的数组。在ts中，也会提供一些小api以完成对类型的裁剪拼接。

1.[]操作符

当我们需要从IUser拿到账户信息的部分

interface IUser {
    userId: number;
    userName: string;
    QRCode: string;
    age: number;
    accountInfo: {
        No: number;
        passWord: number;
    };
}

interface PartOfIUser {
    userId: number;
    accountInfo: {
        No: number;
        passWord: number;
    };
}

如此操作，重复度极高，不利于统一类型来源，一改就要改两次。

bad taste：需要反着写，反直觉

interface PartOfIUser {
    userId: number;
    accountInfo: {
        No: number;
        passWord: number;
    };
}


interface IUser extends PartOfIUser{
    userName: string;
    QRCode: string;
    age: number;
}

good taste：

interface IUser {
    userId: number;
    userName: string;
    QRCode: string;
    age: number;
    accountInfo: {
        No: number;
        passWord: number;
    };
}

interface PartOfIUser {
    userId: IUser['userId'];
    accountInfo: IUser['accountInfo'];
}
// 或者使用类型工具Pick
type PartOfIUser = Pick<IUser, 'userId' | 'accountInfo'>;

2.typeof 操作符

获取某个值的类型属性

const shixin = { name: 'shixin', age: '22' };

type IShixin = typeof shixin;
// 等于
type IShixin = {
    name: string;
    age: string;
}


let num = 1
type n = typeof num
// 等于
type n = number

3.keyof 操作符

TS版本的Object.keys() 可以获取interface的key，组成联合类型

type IShixin = {
    name: string;
    age: string;
};

type Key = keyof IShixin;
//等于
type Key = 'name' | 'age';

4.in 操作符

用于遍历联合类型

type Keys = 'a' | 'b' | 'c';

type Obj = {
    [p in Keys]: unknown;
};

// 等于
type Obj = {
    a: unknown;
    b: unknown;
    c: unknown;
}

5.组合使用操作符

有如下枚举值和函数，当传入的key为ERROR时，将会把相关信息log出来。

enum LogLevel {
    ERROR,
    WARN,
    INFO,
    DEBUG,
}

function printImportant(key: 'ERROR' | 'WARN' | 'INFO' | 'DEBUG', message: string) {
    const num = LogLevel[key];
    if (num <= LogLevel.WARN) {
        console.log('Log level key is:', key);
        console.log('Log level value is:', num);
        console.log('Log level message is:', message);
    }
}

这个时候我们的printImportant函数的key参数其实是和enum强绑定的。而上面的demo，我们是手动帮key参数写出了所有的枚举值。但是有两个问题

  1. 当LogLevel枚举值添加，我们需要在enum和函数的参数都进行修改。假设有N个函数依赖了此枚举，那么当枚举变动，相关类型就需要手动更改N次。
  2. 当枚举值很多的情况，手动声明就显得太蠢。

或许我们需要通过LogLevel自动生成一个枚举值的联合类型，而不是手写。这时候我们就可以使用上面说的typeof + keyof了。

enum LogLevel {
    ERROR,
    WARN,
    INFO,
    DEBUG,
}

// 第一步，通过typeof 拿到enum的类型属性
enum LogLevel {
    ERROR,
    WARN,
    INFO,
    DEBUG,
}

type LogLevelType = typeof LogLevel;
// 等于
type LogLevelType = {
    [x: number]: string;
    readonly ERROR: LogLevel.ERROR;
    readonly WARN: LogLevel.WARN;
    readonly INFO: LogLevel.INFO;
    readonly DEBUG: LogLevel.DEBUG;
};

// 第二步，通过keyof 拿到上面这个枚举类型属性的key组成联合类型

type LogLevelStrings = keyof LogLevelType;
// 等于
type LogLevelStrings = number | 'ERROR' | 'WARN' | 'INFO' | 'DEBUG';

这个LogLevelStrings 就是我们最后需要的啦～整理整理

enum LogLevel {
    ERROR,
    WARN,
    INFO,
    DEBUG,
}

/**
 * This is equivalent to:
 * type LogLevelStrings = 'ERROR' | 'WARN' | 'INFO' | 'DEBUG';
 */
type LogLevelStrings = keyof typeof LogLevel;

function printImportant(key: LogLevelStrings, message: string) {
    const num = LogLevel[key];
    if (num <= LogLevel.WARN) {
        console.log('Log level key is:', key);
        console.log('Log level value is:', num);
        console.log('Log level message is:', message);
    }
}

类型断言

当TS没你聪明的时候，类型推断无法推断出正确的类型。需要你手动指定类型，就是类型断言的使用场景。

还是刚刚的User的例子，我们vue3可能会这样初始化user并且请求数据。

interface IUserRsp {
    userId: number;
    userName: string;
    QRCode: string;
    age: number;
    accountInfo: {
        No: number;
        passWord: number;
    };
}
// 定义初始user对象
const user = ref({});
const requestUser = async () => {
    // 请求user信息
    const res: IUserRsp = await request('/api/user/userInfo');
    //给user赋值
    user.value = res;
    // 当我们想用user里面的accountInfo
    user.value.accountInfo; // error 类型“{}”上不存在属性“userName”。
};

这个时候user必然是IUserRsp类型，那么这个user上面必然有accountInfo，但是却报错了。来吧，as！

这样as

(user as Ref<IUserRsp>).value.accountInfo; // ok

这样as

(user.value as IUserRsp).accountInfo; // ok

另一种as可能更加常见：as any。这是anyScript的重要来源。

(user as any).value.accountInfo; // ok

这样就强制把类型扭转啦，在前两种as，ts的推断系统就会在这一行把user判断成IUserRsp。换句话说，你在这一行代码接管了TS的类型推断。但是其实我们大多数的时候其实并不需要as，as在实践场景更多的是工程师无法（type 无法 = 能力不足｜懒得去找报错源头｜没时间）维护类型系统而使用的偷懒技巧，在大多数使用as的时候，大家为的并不是解决类型系统问题，而是报错问题。而上面的demo，尽管无数次出现在各种项目的代码中，但其实我们可以通过Partial类型工具来让IUserRsp变成可选IUserRsp。

interface IUserRsp {
    userId: number;
    userName: string;
    QRCode: string;
    age: number;
    accountInfo: {
        No: number;
        passWord: number;
    };
}
// 定义初始user对象
const user = ref<Partial<IUserRsp>>({}); // 使用Partial
const requestUser = async () => {
    // 请求user信息
    const res: IUserRsp = await request('/api/user/userInfo');
    //给user赋值
    user.value = res;
    // 当我们想用user里面的accountInfo
    user.value.accountInfo; // OK
};

依然是上面的代码，或许还有一种as

interface IUserRsp {
    userId: number;
    userName: string;
    QRCode: string;
    age: number;
    accountInfo: {
        No: number;
        passWord: number;
    };
}
// 定义初始user对象
const user = ref({} as IUserRsp);
const requestUser = async () => {
    // 请求user信息
    const res: IUserRsp = await request('/api/user/userInfo');
    //给user赋值
    user.value = res;
    // 当我们想用user里面的accountInfo
    user.value.accountInfo; // ok
};

这种看起来是安全的，也是当前很多人的首选，因为当我们初始化的时候把user变成了可选的IUserRsp，就意味着在进行如下情况会报错。

 user.value.accountInfo
 // 可能为
 {
   No: number;
   passWord: number;
 }
 或者undefined
 
 
 //那么如下调用，可能会提示accountInfo没有password，undefined不能直接调用password
 user.value.accountInfo.passWord

当然了，你可以为user制作一个类型守卫，在使用user的时候做一下控制流分析。

const isUser = (user: unknown): user is IUserRsp => !!user['userId'];

但是在写这些麻烦的代码和在初始化的时候as，选择后者可能更加方便。但后者的风险在于如果有个小笨蛋在还没request的时候就调用了user.value.accountInfo，GG。

// 定义初始user对象
const user = ref({} as IUserRsp);

// 有个小笨蛋在还没request的时候就调用了accountInfo
user.value.accountInfo.passWord; // GG

const requestUser = async () => {
    // 请求user信息
    const res: IUserRsp = await request('/api/user/userInfo');
    //给user赋值
    user.value = res;
    // 当我们想用user里面的accountInfo
    user.value.accountInfo.passWord; // ok
};

so,ban-as please!

类型工具

内置类型工具

完成了对泛形的理解，掌握了类型关键字了，我们就可以开始使用一些类型工具了。上面讲到了vue为我们提供的类型工具PropType。让我们方便的传入一个参数，就可以生成该参数对应props的类型。在TS内部也提供了很多类型工具。

属性修饰工具

Partial 可以将一个interface的所有属性都换成可选的，也就是对接口每一项都添加了可选修饰符 '?'

type Partial<T> = {
    [P in keyof T]?: T[P];
};

Required 可以将一个interface的所有属性都换成必选的，也就对接口每一项都删除了可选修饰符 '?'

type Required<T> = {
    [P in keyof T]-?: T[P];
};

Readonly 可以将一个interface的所有属性都换成仅读的，也就对接口每一项都添加了仅读修饰符 'readonly'

type Readonly<T> = {
    readonly [P in keyof T]: T[P];
};

结构工具

Record 常用的对象定义方式

type Record<K extends string | number | symbol, T> = {
	[P in K]: T; 
}

Exclude 联合类型 T中不存在于 U 中的部分

type Exclude<T, U> = T extends U ? never : T;

type T1 = Exclude<1 | 2, 2>; // 1

Pick 同lodash的Pick

type Pick<T, K extends keyof T> = {
    [P in K]: T[P];
};

**Omit ** 同lodash的Omit

type Omit<T, K extends keyof any> = Pick<T, Exclude<keyof T, K>>

怎么实践类型类型工具

在类型系统中对待类型工具就如同在项目系统中对待lodash，尽管类型体操恶心，但是不需要你完成所有具体实现。

推荐ts-toolbelt，该库是目前包含工具类型数量最多的。基本能满足你大多数的常规操作。以满足原生的类型工具不够用，自己又不太会写类型工具、或无法花大量时间去维护类型工具。

一个🌰：

例如我们有以下的Bar接口，并且想把所有的属性都变成可选的。就像最上面 “object、Object 以及 { }”场景一样，只不过这次的对象嵌套比较深了。

interface Boo{
  booA:Array<'3'>
  booB:string
}

interface Bar {
  a: number;
  b: {
    b1: boolean;
    b2: Array<Boo>;
  };
}

在原生的Partial方法下，得到的结果好像不能满足我们的需求，

interface Boo {
    booA: Array<'3'>;
    booB: string;
}

interface Bar {
    a: number;
    b: {
        b1: boolean;
        b2: Array<Boo>;
    };
}

const foobar: Partial<Bar> = {
    b: {
        b1: true,
        b2: [ //类型 "{ booA: "3"[]; }" 中缺少属性 "booB"，但类型 "Boo" 中需要该属性。
            {
                booA: ['3']
            }
        ]
    }
};

因为原生的Partial只能转化第一层索引为可选的。所以我们需要深层的去转换为可选，也就是我们需要递归的去将每一项都转为可选的，具体的就是，如果该项为一个对象，我们就递归调用这个可选方法。

type Partial<T> = {
    [P in keyof T]?: T[P];
};

// to

type DeepPartial<T> = {
  [K in keyof T]?: T[K] extends object ? DeepPartial<T[K]> : T[K]
}

// Ok
const foobar: DeepPartial<Bar> = {
  b:{
    b1:true,
    b2:[{
      booA:['3']
    }]
  }
};

比起如此或许我们可以直接在ts-toolbelt找到 partial 在第二个泛形选择deep，然后我们就得到了一个现成DeepPartial。

import { O } from 'ts-toolbelt';
// OK
const foobar: O.Partial<Bar,'deep'> = {
    b: {
        b1: true,
        b2: [
            {
                booA: ['3']
            }
        ]
    }
};

这里我们不再赘述ts-toolbelt的Partial实现逻辑，另一个值得关注的是ts-toolbelt的Partial单测。这里通过TDD的思想完成了目标效果的确立，来保障类型工具的安全。这点是我们值得借鉴的，比较不是每一次需要的类型工具都可以从ts-toolbelt找到答案，总有自己写的时候。

// https://github.com/millsp/ts-toolbelt/blob/master/tests/Object.ts
type PARTIAL_O_FLAT = {
    a?: string,
    b?: number;
    c?: {a: 'a'} & {b: 'b'};
    d?: 'string0';
    readonly e?: 'string1';
    readonly f?: 0;
    g?: O;
    h?: 1;
    j?: 'a';
    k?: {a: {b: string}};
    x?: () => 1;
};

checks([
    check<O.Partial<O, 'flat'>, PARTIAL_O_FLAT, Test.Pass>(),
    check<O.Path<O.Partial<O, 'deep'>, ['g', 'g']>, O.Partial<O, 'deep'> | undefined, Test.Pass>(),
])

如何通过TDD完成一个类型工具

在TDD的开发模式下，我们会先完成测试用例（目标），再进行对应功能的代码开发（完成目标）。当所有的测试用例通过，就完成了所有的预期功能。当有一个测试用例没有完成，代码就会报错。相当于写了一群监督者检查你的每一个小功能，除了可以帮你检查是否完成预期任务，还可以避免按下葫芦浮起瓢的情况。

假如我们需要一个完成类型工具ObjPaths，拿到一个interface所有的Path路径，以下注释为预期。

type Cases1 = {
  Foo: string;
  Bar: number;
};

type caseRes1 = ObjPaths<Cases1> // ObjPaths需要把Case1转成"Foo" | "Bar"


interface Cases2 {
  Foo: {
    A: string;
    B: string;
  };
  Bar: {
    C: number;
  };
}

type caseRes2 = ObjPaths<Cases2> // ObjPaths需要把Case2转成"Foo" | "Bar" | "Foo.A" | "Foo.B" | "Bar.C"

type Cases3 = {
  Foo: {
    A: string;
    B: string;
  };
  Bar: {
    C: Array<{
      Foo: string;
      Bal: number;
    }>;
  };
};

// ObjPaths需要把Case2转成 "Foo" | "Foo.A" | "Foo.B" | "Bar" | "Bar.C"|"`Bar.C[${number}]`"|`Bar.C[${number}].Bal`|`Bar.C.${number}.Bal`
type caseRes3 = ObjPaths<Cases3>

基于我们的预期，我们可以根据上面的这些小想法，完成单元测试。js的单测我们通常会使用jest，那么TS我们可以自己写常用的判断方法，这里我们用了type-challenges的一些断言方法。

import type { Equal, Expect, ExpectExtends } from '@type-challenges/utils'

Equal<A,B> // 如果A和B在类型上是一样的，就回返回true，否则返回false
ExpectExtends<A,B>// 如果A和B在类型上是A包含B的，就回返回true，否则返回false
Expect<A> //如果A不是true就报错

以此得到


type cases = [
  Expect<Equal<ObjPaths<Cases1>, "Foo" | "Bar">>,
  Expect<Equal<ObjPaths<Cases2>, "Foo" | "Bar" | "Foo.A" | "Foo.B" | "Bar.C">>,

  Expect<ExpectExtends<ObjPaths<Cases3>, `Bar.C[${number}]`>>,
  Expect<ExpectExtends<ObjPaths<Cases3>, `Bar.C[${number}].Bal`>>,
  Expect<ExpectExtends<ObjPaths<Cases3>, `Bar.C.${number}.Bal`>>,
  Expect<ExpectExtends<ObjPaths<Cases3>, "Foo" | "Foo.A" | "Foo.B" | "Bar" | "Bar.C">>
];

接下来，我们要做的就是解决这个case所有的报错，case解决就算工具完成。TS playground链接

/*  -判断当前索引是否为字符串或数字
    -如果不是则返回 never
    -如果是则根据是否是第一层返回不同的结果的 key
    -并且联合上 K 索引的值
    -如果是对象则继续递归联合 */
type IsNumber<T> = T extends number ? `[${T}]` : never;

type ObjPaths<
  T extends object,
  Flag extends boolean = false,
  K extends keyof T = keyof T
> = K extends string | number
  ?
      | (Flag extends true ? `.${K}` | IsNumber<K> : `${K}`)
      | (T[K] extends object
          ? `${Flag extends true ? `.${K}` | IsNumber<K> : `${K}`}${ObjPaths<
              T[K],
              true
            >}`
          : never)
  : never;

如何找到类型工具

对于类型编程，国内外的环境可能还是有比较大的差距。所以当你在使用百度去查找你想要的类型工具，基本是不如自己撸一个来的快。但是Google相对来说会很容易找到你需要的工具答案。如果内置函数，工具库都无法满足你的诉求时，建议去Google进行搜索引擎努力。另一个是 type-challenges 类型版本的leetCode，内置了非常多的类型问题，你也可以从这上面找到对应的答案或实现灵感。

总结

  1. 本篇文档讲述了一些基本的类型操作，和一些小的知识点，讲了一些实际场景的类型问题以及如何完成一个类型工具，并介绍了一些常用的类型工具轮子。类型收敛、类型工具非常重要，优化类型收敛、类型工具都是TS官方近两年迭代的主题，比如关键词satisfies，Awaited类型工具、模版字符串、优化控制流分析等等。
  2. 一篇文章无法覆盖所有的类型API，对于类型的维护，并不需要知道所有的API，但需要清晰将类型收敛到什么程度，才能够满足你的需求。ban了as，ban了any，学会基本的类型操作，知道2022年的类型系统可以做到什么，能够找到你想要的类型工具，积极的使用内置和封装的类型工具合理的去维护项目的类型系统。或许用类型系统写一个国际象棋回报相对较低，但是用用Omit，Google找个ObjPaths难度并不大。
avatar
文章
阅读
粉丝
相关推荐
深入浅出学习TypeScript
2.2k阅读
 · 
49点赞
深入浅出TypeScript
602阅读
 · 
2点赞
深入浅出TypeScript装饰器
1.2k阅读
 · 
5点赞
深入浅出TypeScript | 青训营
1.4k阅读
 · 
6点赞
【你应该掌握的】深入浅出typescript
3.7k阅读
 · 
42点赞