TypeScript之旅

提示：文章写完后，目录可以自动生成，如何生成可参考右边的帮助文档

---

TypeScript常用类型

提示：这里可以添加本文要记录的大概内容：

TypeScript 是 JS 的超集，TS 提供了 JS 的所有功能，并且额外的增加了：类型系统

---

JS 有类型（比如，number/string 等）,但是 JS 不会检查变量的类型是否发生变化，而 TS 会检查
TypeScript 类型系统的主要优势：可以显示标记出代码中的意外行为，从而降低了发生错误的可能性

类型注解

let age:number = 18;
代码中:number就是类型注解

类型注解约束了只能给该变量赋值该类型的值

常用基础类型

可以将 TS 中的常用基础类型分为两类

1.JavaScript 已有类型

• 原始类型： number/string/boolean/null/undefined/symbol
• 对象类型：object(数组、对象、函数等)

2.TypeScript 新增类型

• 联合类型、自定义类型、接口、元祖、字面量类型、枚举、void、any等
  -原始类型在 TS 和 JS 中写法一致， 对象类型在 TS 中更加细化，每个具体对象都有自己的类型语法

原始类型

number/string/boolean/null/undefined/symbol
可完全按照 JavaScript 中的名称来书写

let age:number = 18;
let username:string = '张张';
let isMerry:boolean = false;
let unique:Symbol = Symbol('weiyi')

数组类型

• 类型[]写法，如

let userList:string[] = ['John','Bob'];
let peopleList:object[] = [{name:'张张',age:18
}];

• Array<类型>写法，如

let user2List:Array<string> = ['John','Bob'];
let people2List:Array<object> = [{name:'',age:18
}]

联合类型

• • 组中既有 number 类型，又有 string 类型，这个数组的类型应该如何写?
• • 可以用|(竖线)分割多个类型， 如

let str:string | number = 1;
str = '张张';

• • 如果数组中可以是字符串或者数字，则可以这么写

let arr:Array<number | string> = [1,2,'ss'];

类型别名

• • 当一个复杂类型或者联合类型过多或者被频繁使用时，可以通过类型别名来简化该类型的使用
• • 用法：type名称 = 具体类型

type CustomArray = Array<number | string>;
let arr1:CustomArray  = [1,2,'']

• • type作为创建自定义类型的关键字，可以使用任意合法的变量名称；推荐大驼峰命名方式

函数类型

• • 除了变量，我们常见的类型指定还有针对函数的类型声明
• • 函数类型需要指的是函数参数和返回值的类型，分为两种写法
• 1.单独指定参数，返回值类型

//单独指定函数返回值和函数参数
function add(num1:number,num2:number):number{return num1 + num2;
}
//指定变量形式
const add2 = (num1:number,num2:number):number=>{
return num1+num2; 
}

• 2.同时指定参数和返回值

//
type CustomFunc = (num1:number,num2:number)=>number;
const add3:CustomFunc  = (num1,num2)=>{return num1 + num2;
}

• • 当函数作为表达式时，可以通过类似箭头函数形式的语法来为函数添加类型，这种形式只适用于函数表达式

void类型

• • 当我们的函数定义为没有返回值的类型时，可用关键字void表示

type CustomFunc1 = (username:string,classid:string)=>void;
const combinStr:CustomFunc1 = ()=>{};

• • 如果一个函数没有返回值，此时，在 TS 的类型中，应该使用 void 类型

const add4 = ()=>{};
const add5 = ():void=>{};
const add6 = ():undefined=>{return undefined;
}

函数可选参数

当我们定义函数时，有的参数可传可不传，这种情况下，可以使用 TS 的可选参数来指定类型
比如，在使用数组的slice方法时，我们可以直接使用slice() 也可以传入参数 slice(1) 也可以slice(1,3)

const slice = (start?:number,end?:number):void=>{};

• • ?表示该参数或变量可传可不传
• • 注意：只能出现在参数列表的最后，

对象类型

JS 中的对象是由属性和方法组成的，TS 的对象类型是对象中属性和方法的描述

let person3:{name:string;sayFn:Function;
}={name:'',sayFn(){},
}

总结： 可是使用{}来描述对象结构
属性采用属性名：类型形式

使用类型别名

直接使用{}会降低代码可读性，不具有辨识度，更推荐使用类型别名添加对象类型

type PersonObj = {name:string;sayFn():string;
};
const p1:PersonObj = {name:'',sayFn(){return this.name; }
}

带有参数的方法的类型

如果对象中的函数带有参数，可以在函数中指定参数类型

type PersonObj = {name:string;sayFn(start:number):string;
};
const p1:PersonObj = {name:'',sayFn(start){return this.name; }
}

箭头函数形式的方法类型

type People = {sayFn:(start:number)=>string;
}
const p3:People = {sayFn(){return '';},
};

对象可选属性

对象中的若干属性，有时也是可选的，此时我们依然可以使用?来表示

type Config = {method?:string;url:string;
};
const func = (config:Config )=>{}
func({url:'/a'});

接口interface

当一个对象类型被多次使用时，一般使用接口（interface）描述对象的类型，达到复用的目的

• 我们使用interface关键字来声明接口
• 接口名称推荐以I为开头
• 声明接口之后，直接使用接口名称作为变量的类型

interface IPeople{name:string;age:number;sayFn():void;
}
let p:IPeople = {name:'',age:18,sayFn(){}
}

接口和自定义类型的区别

• 相同点：都可以给对象指定类型
• 不同点： 接口只能为对象指定类型， 类型别名可以为任意类型指定别名

接口继承

• 如果两个接口之间有相同的属性和方法，可以将公共的属性和方法抽离出来，通过继承来实现复用

interface Point2D{x:number;y:number}
interface Point3D extends{z:number
}

元组

• 当我们想定义一个数组中具体索引位置的类型时，可以使用元祖
• 原有的数组模式只能宽泛的定义数组中的普遍类型，无法精确到位置
• 元组是另一种类型的数组，它确切知道包含多少个元素，以及特定索引对应的类型

let position:[number,number] = [];

类型推论

• 在 TS 中，某些没有明确指出类型的地方，TS 的类型推论机制会帮助提供类型
• 也就是说，由于类型推论的存在，在某些地址类型注解可以省略不写。
• 发生类型推论的常见场景
• 声明变量并初始化时
• 决定函数返回值时
• 当变量值是基础类型的时候， 可以省略类型注解。
• 当变量是复杂类型时，不可省略。

TS类型的项目- 要定义类型- 再写逻辑， 这样所有的代码都会有提示，假如没有提示，说明类型不对

let str1 = '张三';
const str2 = '张三';

• 变量 str1 的变量类型为： string
• 变量 str2 的变量类型为 ‘张三’
• str1 是一个变量(let)，它的值可以是任意字符串，所以类型为:string
• str2 是一个常量(const)，它的值不能变化只能是 ‘张三’，所以，它的类型为:‘张三’
• 此时，‘张三’就是一个字面量类型，即某个特殊的字符串也可以作为 TS 中的类型
  任意的 JS 字面量（对象，数组，数字）都可以作为类型使用
  使用场景和模式
• 使用模式：字面量类型配合联合类型一起使用
• 使用场景：用来表示一组明确的可选值列表

枚举

• 枚举的功能类似于字面量类型+联合类型组合的功能，也可以表示一组明确的可选值
• 枚举：定义一组命名常量。它描述一个值，该值可以是这些命名常量中的一个

enum Direction2{Up,Down,Left,Right,
}
function changeDirection(direction:Direction2){}
changeDirection(Direction2.Up)

• 调用函数时，需要应该传入：枚举 Direction 成员的任意一个
• 类似于 JS 中的对象，直接通过 点（.）语法 访问枚举的成员

数字枚举

• 问题：我们把枚举成员作为了函数的实参，它的值是什么呢?
• 解释：通过将鼠标移入 Direction.Up，可以看到枚举成员 Up 的值为 0
• 注意：枚举成员是有值的，默认为：从 0 开始自增的数值
• 我们把，枚举成员的值为数字的枚举，称为：数字枚举
• 当然，也可以给枚举中的成员初始化值

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

字符串枚举

• 字符串枚举：枚举成员的值是字符串
• 注意：字符串枚举没有自增长行为，因此，字符串枚举的每个成员必须有初始值

enum Direction{Up = 'UP',Down = 'DOWN',Left = 'LEFT'
}

枚举实现原理

• 枚举是 TS 为数不多的非 JavaScript 类型级扩展(不仅仅是类型)的特性之一
• 因为：其他类型仅仅被当做类型，而枚举不仅用作类型，还提供值(枚举成员都是有值的)
• 也就是说，其他的类型会在编译为 JS 代码时自动移除。但是，枚举类型会被编译为 JS 代码
• 说明：枚举与前面讲到的字面量类型+联合类型组合的功能类似，都用来表示一组明确的可选值列表
• 一般情况下，推荐使用字面量类型+联合类型组合的方式，因为相比枚举，这种方式更加直观、简洁、高效

any类型

• 原则:不推荐使用 any!这会让 TypeScript 变为 “AnyScript”(失去 TS 类型保护的优势)
• 因为当值的类型为 any 时，可以对该值进行任意操作，并且不会有代码提示

let obj:any = {x:0};
obj.bar = 100;
obj();
const n:number = obj;

类型断言

• 有时候你会比 TS 更加明确一个值的类型，此时，可以使用类型断言来指定更具体的类型

const aLink = document.getElementById('link');

• 该方法返回值的类型是 HTMLElement，该类型只包含所有标签公共的属性或方法，不包含 a 标签特有的 href 等属性
• 因此，这个类型太宽泛(不具体)，无法操作 href 等 a 标签特有的属性或方法
• 解决方式：这种情况下就需要使用类型断言指定更加具体的类型

const aLink = document.getElementById('link') as HTMLAnchorElement;

• 使用 as 关键字实现类型断言
• 关键字as后面的类型是一个更加具体的类型
• 通过类型断言，aLink的类型变得更加具体
• 另一种语法，使用<>语法，

typeof

• TS 也提供了 typeof 操作符：可以在类型上下文中引用变量或属性的类型（类型查询）
• 使用场景:根据已有变量的值，获取该值的类型，来简化类型书写

let p = {x:1,y:2};
function formatPoint(point:{x:number;y:number}){}
formatPoint(p)
function formatPoint(point:typeof p){}

• 使用 typeof 操作符来获取变量 p 的类型，结果与第一种（对象字面量形式的类型）相同
• typeof 出现在类型注解的位置（参数名称的冒号后面）所处的环境就在类型上下文(区别于 JS 代码)
• typeof 只能用来查询变量或属性的类型，无法查询其他形式的类型（比如，函数调用的类型）

高级类型

类型兼容性

• 两种类型系统：结构化类型系统和标明类型系统
• TS采用的是结构化类型系统，
• 也就是说，在结构类型系统中，如果两个对象具有相同的形状，则认为它们属于同一类型
  函数类型的类型兼容性比较复杂，需要考虑：1 参数个数 2 返回值类型
• 参数个数：参数多的兼容参数少的(或者说，参数少的可以赋值给多的)
• • 在 JS 中省略用不到的函数参数实际上是很常见的，这样的使用方式，促成了 TS 中函数类型之间的兼容性

泛型概述

• 泛型可以在保证类型安全前提下，让函数等与多种类型一起工作，从而实现复用，常用于：函数、接口、class中
• 需求：创建一个id函数，传入什么数据就返回该数据本身

function id(value:number):number{return value;
}
const res = id(10);

• 比如，id(10) 调用以上函数就会直接返回 10 本身。但是，该函数只接收数值类型，无法用于其他类型
• 为了能让函数能够接受任意类型的参数，可以将参数类型修改为 any。但是，这样就失去了 TS 的类型保护，类型不安全
• 此时，泛型的作用就显示出来了
• 泛型在保证类型安全的同时，可以让函数与多种不同的类型一起工作，灵活可复用

泛型函数

function id<T>(value:T):T{return value;
}
const num = id<number>(10);
const str = id<string>('a')

• 语法：在函数名称的后面添加 <>（尖括号），尖括号中指定具体的类型，比如，此处的 number
• 当传入类型 number 后，这个类型就会被函数声明时指定的类型变量 Type 捕获到
• 此时，Type 的类型就是 number，所以，函数 id 参数和返回值的类型也都是 number
• 这样，通过泛型就做到了让 id 函数与多种不同的类型一起工作，实现了复用的同时保证了类型安全

简化泛型函数调用

• 在调用泛型函数时，可以省略 <类型> 来简化泛型函数的调用

let num = id(10);
let str = id('a');

• 此时，TS 内部会采用一种叫做类型参数推断的机制，来根据传入的实参自动推断出类型变量 Type 的类型
• 比如，传入实参 10，TS 会自动推断出变量 num 的类型 number，并作为 Type 的类型
• 推荐：使用这种简化的方式调用泛型函数，使代码更短，更易于阅读
• 说明：当编译器无法推断类型或者推断的类型不准确时，就需要显式地传入类型参数

泛型约束

• 默认情况下，泛型函数的类型变量 Type 可以代表任意类型，这导致无法访问任何属性
• 因为 Type 可以代表任意类型，无法保证一定存在 length 属性，比如 number 类型就没有 length。因此，无法访问 length 属性

function id<Type>(value:Type):Type{
//注意：此处会报错
console.log(value.length);return value;
}
id('a')

• 此时，就需要为泛型添加约束了 收缩类型
• 添加泛型约束收缩类型，主要有以下两种方式：1 指定更加具体的类型 2 添加约束
• 如何指定更加具体的类型：
• 将类型修改为 Type[](Type 类型的数组)，因为只要是数组就一定存在 length 属性，因此就可以访问

function id<Type>(value:Type[]):Type[]{
//注意：此处会报错
console.log(value.length);return value;
}

添加泛型约束

• 能够使用 extends 关键字来为泛型函数添加类型约束

//创建一个自定义类型
interface ILength{length:number;
}
//Type extends ILength 添加泛型约束
//表示传入的类型必须满足ILength 接口的要求才行
function id<Type extends ILength>(value:Type):Type{console.log(value.length);return value;
}

• 创建描述约束的接口 ILength，该接口要求提供 length 属性
• 通过 extends 关键字来为泛型（类型变量）添加约束
• 该约束表示：传入的类型必须具有 length 属性
• 注意：传入的实参（比如，数组）只要有 length 属性即可（类型兼容性)

多个类型变量的泛型

• 泛型可以有多个类型变量，并且类型变量之间还可以约束(比如，第二个类型变量受第一个类型变量约束
• 创建一个函数来获取对象中属性的值：

function getProp<Type,key extends keyof Type>(obj:Type,key:key){return obj[key];
}
let person = {name:'',age:18
};
getProp(person,'name')

• 添加了第二个类型变量 Key，两个类型变量之间使用 , 逗号分隔。
• keyof 关键字接收一个对象类型，生成其键名称(可能是字符串或数字)的联合类型
• 本示例中 keyof Type 实际上获取的是 person 对象所有键的联合类型，也就是：‘name’ | ‘age’
• 类型变量 Key 受 Type 约束，可以理解为：Key 只能是 Type 所有键中的任意一个，或者说只能访问对象中存在的属性

//Type extends object表示：Type应该是一个对象类型，如果不是对象类型，就会报错
function getProperty<Type extends object,key extends keyof Type>(obj:Type,key:key,){return obj[key];
}

泛型接口

• 接口也可以配合泛型来使用，以增加其灵活性，增强其复用性

interface IdFunc<Type>{id:(value:Type)=>Type;ids:()=>Type[];
}
let obj:IdFunc<number>={if(value){return value; },ids(){return [1,3,5] }
}

• 在接口名称的后面添加 <类型变量>，那么，这个接口就变成了泛型接口
• 接口的类型变量，对接口中所有其他成员可见，也就是接口中所有成员都可以使用类型变量
• 使用泛型接口时，需要显式指定具体的类型(比如，此处的 IdFunc)。
• 此时，id 方法的参数和返回值类型都是 number;ids 方法的返回值类型是 number[]。
• 实际上，JS 中的数组在 TS 中就是一个泛型接口

泛型工具类型

• 泛型工具类型：TS 内置了一些常用的工具类型，来简化 TS 中的一些常见操作
• 它们都是基于泛型实现的(泛型适用于多种类型，更加通用)，并且是内置的，可以直接在代码中使用。 这些工具类型有很多
• Partial
• Readonly
• Pick<Type, Keys>

Partial

• Partial 用来构造(创建)一个类型，将 Type 的所有属性设置为可选

type Props = {id:string;children:number[];
};
type PartialProps = Partial<Props>;

• 构造出来的新类型 PartialProps 结构和 Props 相同，但所有属性都变为可选的

readonly

-Readonly 用来构造一个类型，将 Type 的所有属性都设置为 readonly(只读)

pick

• Pick<Type, Keys> 从 Type 中选择一组属性来构造新类型

interface Props {id: string;title: string;children: number[];
}
type PickProps = Pick<Props, 'id' | 'title'>;

• Pick 工具类型有两个类型变量:1 表示选择谁的属性 2 表示选择哪几个属性
• 其中第二个类型变量，如果只选择一个则只传入该属性名即可，如果有多个使用联合类型即可。
• 第二个类型变量传入的属性只能是第一个类型变量中存在的属性
• 构造出来的新类型 PickProps，只有 id 和 title 两个属性类型