TypeScript入门
前言
特别声明:本文为个人学习 TypeScript 而编写的笔记,我刚入手TypeScript,如果有写的不对的,请多指教!!!
一、基本数据类型
let str: string = "jimmy";
let num: number = 24;
let bool: boolean = false;
let u: undefined = undefined;
let n: null = null;
let sym: symbol = Symbol("me");
二、引用数据类型
1、Array
对数组类型的定义有两种方式: let arr:string[] = ['5','6']
let arr:Array
定义联合类型数组 let arr: (string | number | boolean)[] = [5, 6, '90', true, false]
定义指定对象成员的数组 interface arrObj{
name:string,
age:number
}
let arr1:arrObj[] = [
{name:'112',age:20},
]
2、函数
函数声明 function fn(x: number, y: number): number {
return x + y
}
console.log(fn(100, 6000));
函数表达式 const fn = (x: number, y: number): (void | number) => {
return x + y
}
console.log(fn(10,20))
可选参数 注意:可选参数后面不允许再出现必需参数 function testFn(firstName: string, lastName?: string): string {
if (lastName) {
return firstName + '加' + lastName
} else {
return firstName
}
};
let fn1 = testFn("小明", "小红");
let fn2 = testFn("小明");
console.log(fn1);
console.log(fn2);
参数默认值 function testFn(firstName: string, lastName: string = '小刚'): string {
if (lastName) {
return firstName + '加' + lastName
} else {
return firstName
}
};
let fn1 = testFn("小明", "小红");
let fn2 = testFn("小明");
console.log(fn1);
console.log(fn2);
剩余参数 function push(arr: any[], ...items: any[]) {
items.forEach(item => {
arr.push(item)
})
}
let cont: any = []
push(cont, 1, 2, 3, 6,false,'附件')
console.log(cont);
函数重载 由于 JavaScript 是一个动态语言,我们通常会使用不同类型的参数来调用同一个函数,该函数会根据不同的参数而返回不同的类型的调用结果 function addFn(x,y){
return x+y
}
console.log(addFn(1,2)); // 3
console.log(addFn('1','2')); // 12
由于 TypeScript 是 JavaScript 的超集,因此以上的代码可以直接在 TypeScript 中使用,但当 TypeScript 编译器开启 noImplicitAny 的配置项时,以上代码会提示以下错误信息: Parameter 'x' implicitly has an 'any' type.
Parameter 'y' implicitly has an 'any' type.
参数“x”隐式具有“any”类型。
参数“y”隐式具有“any”类型。
该信息告诉我们参数 x 和参数 y 隐式具有 any 类型。为了解决这个问题,我们可以为参数设置一个类型。因为我们希望 add 函数同时支持 string 和 number 类型,因此我们可以定义一个 string | number 联合类型,同时我们为该联合类型取个别名: type Combinable = string | number;
function addFn(x:Combinable,y:Combinable){
if(typeof x === 'string' || typeof y === 'string'){
return x.toString() + y.toString()
}
return x + y
}
为 addFn 函数的参数显式设置类型之后,之前错误的提示消息就消失了。那么此时的 add 函数就完美了么,我们来实际测试一下: const result = addFn('Semlinker','Kakuqo')
result.split(' ');
在上面代码中,我们分别使用 'Semlinker' 和 ' Kakuqo' 这两个字符串作为参数调用 addFn,并把调用结果保存到一个名为 result 的变量上,这时候我们想当然的认为此时 result 的变量的类型为 string,所以我们就可以正常调用字符串对象上的 split 方法。但这时 TypeScript 编译器又出现以下错误信息了: 类型“string | number”上不存在属性“split”。
类型“number”上不存在属性“split”
很明显 number 类型的对象上并不存在 split 属性。问题又来了,那如何解决呢?这时我们就可以利用 TypeScript 提供的函数重载特性。
函数重载或方法重载是使用相同名称和不同参数数量或类型创建多个方法的一种能力。 要解决前面遇到的问题,方法就是为同一个函数提供多个函数类型定义来进行函数重载,编译器会根据这个列表去处理函数的调用。
type Combinable = string | number;
function addFn(x:number,y:number):number;
function addFn(x:string,y:string):string;
function addFn(x:string,y:number):string;
function addFn(x:number,y:string):string;
function addFn(x:Combinable,y:Combinable){
if(typeof x === 'string' || typeof y === 'string'){
return x.toString() + y.toString()
}
return x + y
}
const result = addFn('Semlinker','Kakuqo')
result.split(' ');
在以上代码中,我们为 addFn 提供了多个函数类型定义,从而实现函数的重载。之后,可恶的错误消息又消失了,因为这时 result 变量的类型是 string 类型。
3、Tuple(元组)
元组定义 数组一般由同种类型的值组成,但有时我们需要在单个变量中存储不同类型的值,这时候我们就可以使用元组。在 JavaScript 中是没有元组的,元组是 TypeScript 中特有的类型,其工作方式类似于数组。 元组最重要的特性是可以限制数组元素的个数和类型,它特别适合用来实现多值返回。 元组用于保存定长定数据类型的数据 // 数组必须匹配每个下标的类型,并且元素个数也必须匹配对应定义的个数
let arr: [number, string]
arr = [10,'hello'] // success
arr = ['hello',10] // error
arr = [10,'hello','TypeScript'] // error
**注意:元组类型只能表示一个已知元素数量和类型的数组,长度已指定,越界访问会提示错误。如果一个数组中可能有多种类型,数量和类型都不确定,那就直接 any[] ** 元组类型的解构赋值 我们可以通过下标的方式来访问元组中的元素,当元组中的元素较多时,这种方式并不是那么便捷。其实元组也是支持解构赋值的: let arr: [number, string] = [10,'hello']
let [id,word] = arr
console.log(id); // 10
console.log(word); // hello
元组类型的可选元素 与函数签名类似,在定义元组类型时,我们也可以通过 ? 号来声明元组类型的可选元素,具体的示例如下: // 第二个元素可以没有,如果有必须是number类型
let optionsTuple : [string,number?];
optionsTuple = ['hello'] // success
optionsTuple = ['hello',90] // success
元祖类型的剩余元素 元组类型里最后一个元素可以是剩余元素,形式为 ...X,这里 X 是数组类型。剩余元素代表元组类型是开放的,可以有零个或多个额外的元素。 type RestTupleType = [number,...string[]]
let arr:RestTupleType = [666,'一','二','三']
只读的元组类型 可以为任何元组类型加上 readonly 关键字前缀,以使其成为只读元组。 let optionsTuple : readonly [string,number] = ['hello',100]
注意:在使用 readonly 关键字修饰元组类型之后,任何企图修改元组中元素的操作都会抛出异常。
4、void
void表示没有任何类型,和其他类型是平等关系,不能直接赋值:
let a: void;
let b: number = a; // Error
只能为它赋予null和undefined。声明一个void类型的变量没有什么大用,一般也只有在函数没有返回值时去声明。
注意:方法没有返回值将得到undefined,但是我们需要定义成void类型,而不是undefined类型。
function fu(): undefined {
console.log("this is TypeScript");
};
fu(); // Error
5、never
出处:https://juejin.cn/post/7018805943710253086
never类型表示的是那些永不存在的值的类型。
值会永不存在的两种情况:
如果一个函数执行时抛出了异常,那么这个函数永远不存在返回值(因为抛出异常会直接中断程序运行,这使得程序运行不到返回值那一步,即具有不可达的终点,也就永不存在返回了); 函数中执行无限循环的代码(死循环),使得程序永远无法运行到函数返回值那一步,永不存在返回。 // 异常
function err(msg: string): never { // OK
throw new Error(msg);
}
// 死循环
function loopForever(): never { // OK
while (true) {};
}
never类型同null和undefined一样,也是任何类型的子类型,也可以赋值给任何类型。
但是没有类型是never的子类型或可以赋值给never类型(除了never本身之外),即使any也不可以赋值给never
let ne: never;
let nev: never;
let an: any;
ne = 123; // Error
ne = nev; // OK
ne = an; // Error
ne = (() => { throw new Error("异常"); })(); // OK
ne = (() => { while(true) {} })(); // OK
在 TypeScript 中,可以利用 never 类型的特性来实现全面性检查,具体示例如下:
type Foo = string | number;
function controlFlowAnalysisWithNever(foo: Foo) {
if (typeof foo === "string") {
// 这里 foo 被收窄为 string 类型
} else if (typeof foo === "number") {
// 这里 foo 被收窄为 number 类型
} else {
// foo 在这里是 never
const check: never = foo;
}
}
注意在 else 分支里面,我们把收窄为 never 的 foo 赋值给一个显示声明的 never 变量。如果一切逻辑正确,那么这里应该能够编译通过。但是假如后来有一天你的同事修改了 Foo 的类型:
type Foo = string | number | boolean;
然而他忘记同时修改 controlFlowAnalysisWithNever 方法中的控制流程,这时候 else 分支的 foo 类型会被收窄为 boolean 类型,导致无法赋值给 never 类型,这时就会产生一个编译错误。通过这个方式,我们可以确保controlFlowAnalysisWithNever 方法总是穷尽了 Foo 的所有可能类型。 通过这个示例,我们可以得出一个结论:使用 never 避免出现新增了联合类型没有对应的实现,目的就是写出类型绝对安全的代码。
6、any
在 TypeScript 中,任何类型都可以被归为 any 类型。这让 any 类型成为了类型系统的顶级类型.
如果是一个普通类型,在赋值过程中改变类型是不被允许的:
let a: string = 'seven';
a = 7; // Error
但如果是 any 类型,则允许被赋值为任意类型。
let a: any = 666;
a = "Semlinker";
a = false;
a = 66
a = undefined
a = null
a = []
a = {}
在any上访问任何属性都是允许的,也允许调用任何方法
let anyThing: any = 'hello';
console.log(anyThing.myName);
console.log(anyThing.myName.firstName);
let anyThing: any = 'Tom';
anyThing.setName('Jerry');
anyThing.setName('Jerry').sayHello();
anyThing.myName.setFirstName('Cat');
变量如果在声明的时候,未指定其类型,那么它会被识别为任意值类型
let something; 等价于 let something: any;
something = 'seven';
something = 7;
something.setName('Tom');
在许多场景下,这太宽松了。使用 any 类型,可以很容易地编写类型正确但在运行时有问题的代码。如果我们使用 any 类型,就无法使用 TypeScript 提供的大量的保护机制。请记住,any 是魔鬼!尽量不要用any。
为了解决 any 带来的问题,TypeScript 3.0 引入了 unknown 类型。
7、unknown
unknown与any一样,所有类型都可以分配给unknown:
let notSure: unknown = 4;
notSure = "maybe a string instead"; // OK
notSure = false; // OK
unknown与any的最大区别是: 任何类型的值可以赋值给any,同时any类型的值也可以赋值给任何类型。unknown 任何类型的值都可以赋值给它,但它只能赋值给unknown和any。
let notSure: unknown = 4;
let uncertain: any = notSure; // OK
let notSure: any = 4;
let uncertain: unknown = notSure; // OK
let notSure: unknown = 4;
let uncertain: number = notSure; // Error
如果不缩小类型,就无法对unknown类型执行任何操作:]
function getDog() {
return '123'
}
const dog: unknown = {hello: getDog};
dog.hello(); // Error
这种机制起到了很强的预防性,更安全,这就要求我们必须缩小类型,我们可以使用typeof、类型断言等方式来缩小未知范围:
function getDogName() {
let x: unknown;
return x;
};
const dogName = getDogName();
// 直接使用
const upName = dogName.toLowerCase(); // Error
// typeof
if (typeof dogName === 'string') {
const upName = dogName.toLowerCase(); // OK
}
// 类型断言
const upName = (dogName as string).toLowerCase(); // OK
8、Number、String、Boolean、Symbol
初学 TypeScript 时,很容易把原始类型 number、string、boolean、symbol 和首字母大写的 Number、String、Boolean、Symbol 类型混淆,后者是相应原始类型的 包装对象,姑且把它们称之为对象类型。
从类型兼容性上看,原始类型兼容对应的对象类型,反过来对象类型不兼容对应的原始类型。
let num: number;
let Num: Number;
Num = num; // ok
num = Num; // ts(2322)报错
因此,我们需要铭记不要使用对象类型来注解值的类型,因为这没有任何意义。
三、类型推断
**释义:在很多情况下,TypeScript 会根据上下文环境自动推断出变量的类型,无须我们再写明类型注解,TypeScript 这种基于赋值表达式推断类型的能力称之为类型推断 ** 在 TypeScript 中,具有初始化值的变量、有默认值的函数参数、函数返回的类型都可以根据上下文推断出来。比如我们能根据 return 语句推断函数返回的类型,如下代码所示: // 根据参数的类型,推断出返回值的类型也是 number
const add1 = (x:number,y:number)=>{
return x + y
}
// 推断出 x1 的类型也是 number
const x1 = add1(10,20)
如果定义的时候没有赋值,不管之后有没有赋值,都会被推断成 any 类型而完全不被类型检查:
let gender // 类型推断为any
gender = 23
gender = '23'
四、类型断言
开发中一定会遇到这样的情况,你比 TypeScript 更了解某个值的类型,通常这会发生在你清楚地知道一个实体具有比它现有类型更准确的类型。
可以通过类型断言这种方式告诉编译器,“相信我,我知道自己在干什么”。类型断言好比其他语言里的类型转换,但是不进行特殊的数据检查和解构。它没有运行时的影响,只是在编译阶段起作用。
TypeScript 类型检测无法做到绝对智能,毕竟程序不能像人一样思考。有时会碰到我们比 TypeScript 更清楚实际类型的情况,比如下面的例子:
const arr: number[] = [1, 2, 3, 4];
const aaa: number = arrayNumber.find(num => num > 2); // ts提示:不能将类型“undefined”分配给类型“number”
console.log(aaa);
其中,aaa一定是一个数字(确切地讲是 3),因为 arr中明显有大于 2 的成员,但静态类型对运行时的逻辑无能为力。在 TypeScript 看来,aaa的类型既可能是数字,也可能是 undefined,所以上面的示例中提示了一个 ts(2322) 错误,此时我们不能把类型 undefined 分配给类型 number。
不过,我们可以使用一种笃定的方式 — 类型断言(类似仅作用在类型层面的强制类型转换)告诉 TypeScript 按照我们的方式做类型检查。
比如,我们可以使用 as 语法做类型断言,如下代码所示:
const arr: number[] = [1, 2, 3, 4];
const aaa: number = arr.find(num => num > 2) as number;
console.log(aaa);
1、语法
// 尖括号语法
let str:any = 'hello TypeScript'
let strLen:number = (
console.log(strLen);
// as 语法
let strValue:any = "Hello TypeScript"
let strValLen:number = (strValue as string).length
console.log(strValLen);
注意:以上两种方式虽然没有任何区别,但是尖括号格式会与react中JSX产生语法冲突,因此我们更推荐使用 as 语法。
2、非空断言
在上下文中当类型检查器无法断定类型时,一个新的后缀表达式操作符 ! 可以用于断言操作对象是非 null 和非 undefined 类型。具体而言,x! 将从 x 值域中排除 null 和 undefined 。 let str: string | null | undefined
str!.toString() // success
str.toString() // str可能为 “null” 或“未定义”
type numStr = () => number
function fn(numStr:numStr | undefined){
const num2 = numStr!(); // success
const num1 = numStr(); // “numStr”可能为“未定义” 不能调用可能是“未定义”的对象。
}
3、确定赋值断言
允许在实例属性和变量声明后面放置一个 ! 号,从而告诉 TypeScript 该属性会被明确地赋值。为了更好地理解它的作用,我们来看个具体的例子: let num:number
console.log(2 * num); // ts提示:在赋值前使用了变量“num”
valuation()
function valuation(){
num = 100
}
很明显该异常信息是说变量 num 在赋值前被使用了,要解决该问题,我们可以使用确定赋值断言 let num!:number
console.log(2 * num); // success
valuation()
function valuation(){
num = 100
}
通过 let x!: number; 确定赋值断言,TypeScript 编译器就会知道该属性会被明确地赋值。
五、字面量类型
在 TypeScript 中,字面量不仅可以表示值,还可以表示类型,即所谓的字面量类型。
目前,TypeScript 支持 3 种字面量类型:字符串字面量类型、数字字面量类型、布尔字面量类型,对应的字符串字面量、数字字面量、布尔字面量分别拥有与其值一样的字面量类型,具体示例如下:
let specifiedStr : 'this is string' = 'this is string'
let specifiedNum : 10 = 10
let specifiedBoolean : true = true
比如 ‘this is string’ (这里表示一个字符串字面量类型)类型是 string 类型(确切地说是 string 类型的子类型),而 string 类型不一定是 ‘this is string’(这里表示一个字符串字面量类型)类型,如下具体示例:
let specifiedStr: 'this is string' = 'this is string';
let str: string = 'any string';
specifiedStr = str; // 不能将类型“string”分配给类型“"this is string"”
str = specifiedStr; // success
比如说我们用“马”比喻 string 类型,即“黑马”代指 ‘this is string’ 类型,“黑马”肯定是“马”,但“马”不一定是“黑马”,它可能还是“白马”“灰马”。因此,‘this is string’ 字面量类型可以给 string 类型赋值,但是 string 类型不能给 ‘this is string’ 字面量类型赋值,这个比喻同样适合于形容数字、布尔等其他字面量和它们父类的关系。
1、字符串字面量类型
一般来说,我们可以使用一个字符串字面量类型作为变量的类型,如下代码所示:
let str:'hello' = 'hello';
str = 'hi' // 不能将类型“"hi"”分配给类型“"hello"”。
实际上,定义单个的字面量类型并没有太大的用处,它真正的应用场景是可以把多个字面量类型组合成一个联合类型,用来描述拥有明确成员的实用的集合。
如下代码所示,我们使用字面量联合类型描述了一个明确、可 ‘up’ 可 ‘down’ 的集合,这样就能清楚地知道需要的数据结构了。
type Direction = 'up' | 'down'
function move(dir:Direction){
}
move('up') // success
move('down') // success
move('par') // 类型“"par"”的参数不能赋给类型“Direction”的参数
通过使用字面量类型组合的联合类型,我们可以限制函数的参数为指定的字面量类型集合,然后编译器会检查参数是否是指定的字面量类型集合里的成员。
因此,相较于使用 string 类型,使用字面量类型(组合的联合类型)可以将函数的参数限定为更具体的类型。这不仅提升了程序的可读性,还保证了函数的参数类型,可谓一举两得
2、数字字面量类型以及布尔字面量类型
数字字面量类型和布尔字面量类型的使用与字符串字面量类型的使用类似,我们可以使用字面量组合的联合类型将函数的参数限定为更具体的类型,比如声明如下所示的一个类型 Config:
interface Config {
size: 'small' | 'large';
isEnable: true | false;
margin : 6 | 8 | 10
}
在上述代码中,我们限定了 size 属性为字符串字面量类型 ‘small’ | ‘large’ ,isEnable 属性为布尔字面量类型 true | false(布尔字面量只包含 true 和 false,true | false 的组合跟直接使用 boolean 没有区别),margin 属性为数字字面量类型 6 | 8 | 10。
3、let 和 const 分析
先来看一个 const 示例,如下代码所示:
const str = 'this is string' // const str: "this is string"
const num = 10 // const num: 10
const bool = true // const bool: true
在上述代码中,我们将 const 定义为一个不可变更的常量,在缺省类型注解的情况下,TypeScript 推断出它的类型直接由赋值字面量的类型决定,这也是一种比较合理的设计。
接下来看看如下所示的 let 示例:
let str = 'this is string' // let str: string
let num = 10 // let num: number
let bool = true // let bool: boolean
在上述代码中,缺少显式类型注解的可变更的变量的类型转换为了赋值字面量类型的父类型,比如 str 的类型是 ‘this is string’ 类型(这里表示一个字符串字面量类型)的父类型 string,num 的类型是 10 类型的父类型 number。
这种设计符合编程预期,意味着我们可以分别赋予 str 和 num 任意值(只要类型是 string 和 number 的子集的变量):
let str = 'this is string' // let str: string
let num = 10 // let num: number
let bool = true // let bool: boolean
str = 'any string'
num = 20
bool = false
我们将 TypeScript 的字面量子类型转换为父类型的这种设计称之为 literal widening(类型拓宽),也就是字面量类型的拓宽,比如上面示例中提到的字符串字面量类型转换成 string 类型,下面着重介绍一下。
4、类型拓宽(literal widening)
所有通过 let 或 var 定义的变量、函数的形参、对象的非只读属性,如果满足指定了初始值且未显式添加类型注解的条件,那么它们推断出来的类型就是指定的初始值字面量类型拓宽后的类型,这就是字面量类型拓宽。
通过字符串字面量的示例来理解一下字面量类型拓宽:
let str = 'this is string'; // 类型是 string
let strFun = (str = 'this is string') => str; // 类型是 (str?: string) => string;
const specifiedStr = 'this is string'; // 类型是 'this is string'
let str2 = specifiedStr; // 类型是 'string'
let strFun2 = (str = specifiedStr) => str; // 类型是 (str?: string) => string;
因为第 1~2 行满足了 let、形参且未显式声明类型注解的条件,所以变量、形参的类型拓宽为 string(形参类型确切地讲是 string | undefined)。
因为第 3 行的常量不可变更,类型没有拓宽,所以 specifiedStr 的类型是 ‘this is string’ 字面量类型。
第 4~5 行,因为赋予的值 specifiedStr 的类型是字面量类型,且没有显式类型注解,所以变量、形参的类型也被拓宽了。其实,这样的设计符合实际编程诉求。我们设想一下,如果 str2 的类型被推断为 ‘this is string’,它将不可变更,因为赋予任何其他的字符串类型的值都会提示类型错误。
基于字面量类型拓宽的条件,我们可以通过如下所示代码添加显示类型注解控制类型拓宽行为。
{
const specifiedStr: 'this is string' = 'this is string'; // 类型是 '"this is string"'
let str2 = specifiedStr; // 即便使用 let 定义,类型是 'this is string'
}
实际上,除了字面量类型拓宽之外,TypeScript 对某些特定类型值也有类似 “Type Widening” (类型拓宽)的设计,下面我们具体来了解一下。
比如对 null 和 undefined 的类型进行拓宽,通过 let、var 定义的变量如果满足未显式声明类型注解且被赋予了 null 或 undefined 值,则推断出这些变量的类型是 any:
{
let x = null; // 类型拓宽成 any
let y = undefined; // 类型拓宽成 any
/** -----分界线------- */
const z = null; // 类型是 null
/** -----分界线------- */
let anyFun = (param = null) => param; // 形参类型是 null
let z2 = z; // 类型是 null
let x2 = x; // 类型是 null
let y2 = y; // 类型是 undefined
}
注意:在严格模式下,一些比较老的版本中(2.0)null 和 undefined 并不会被拓宽成“any”。
假设你正在编写一个向量库,你首先定义了一个 Vector3 接口,然后定义了 getComponent 函数用于获取指定坐标轴的值:
interface Vector3 {
x: number;
y: number;
z: number;
}
function getComponent(vector: Vector3, axis: "x" | "y" | "z") {
return vector[axis];
}
但是,当你尝试使用 getComponent 函数时,TypeScript 会提示以下错误信息:
let x = "x";
let vec = { x: 10, y: 20, z: 30 };
// 类型“string”的参数不能赋给类型“"x" | "y" | "z"”的参数。
getComponent(vec, x); // Error
为什么会出现上述错误呢?通过 TypeScript 的错误提示消息,我们知道是因为变量 x 的类型被推断为 string 类型,而 getComponent 函数期望它的第二个参数有一个更具体的类型。这在实际场合中被拓宽了,所以导致了一个错误。
这个过程是复杂的,因为对于任何给定的值都有许多可能的类型。例如:
const arr = ['x', 1];
上述 arr 变量的类型应该是什么?这里有一些可能性:
(‘x’ | 1)[][‘x’, 1][string, number]readonly [string, number](string | number)[]readonly (string|number)[][any, any]any[]
没有更多的上下文,TypeScript 无法知道哪种类型是 “正确的”,它必须猜测你的意图。尽管 TypeScript 很聪明,但它无法读懂你的心思。它不能保证 100% 正确,正如我们刚才看到的那样的疏忽性错误。
在下面的例子中,变量 x 的类型被推断为字符串,因为 TypeScript 允许这样的代码:
let x = 'semlinker';
x = 'kakuqo';
x = 'lolo';
对于 JavaScript 来说,以下代码也是合法的:
let x = 'x';
x = /x|y|z/;
x = ['x', 'y', 'z'];
在推断 x 的类型为字符串时,TypeScript 试图在特殊性和灵活性之间取得平衡。一般规则是,变量的类型在声明之后不应该改变,因此 string 比 string|RegExp 或 string|string[] 或任何字符串更有意义。
TypeScript 提供了一些控制拓宽过程的方法。其中一种方法是使用 const。如果用 const 而不是 let 声明一个变量,那么它的类型会更窄。事实上,使用 const 可以帮助我们修复前面例子中的错误:
const x = "x"; // type is "x"
let vec = { x: 10, y: 20, z: 30 };
getComponent(vec, x); // OK
因为 x 不能重新赋值,所以 TypeScript 可以推断更窄的类型,就不会在后续赋值中出现错误。因为字符串字面量型 “x” 可以赋值给 “x”|“y”|“z”,所以代码会通过类型检查器的检查。
然而,const 并不是万灵药。对于对象和数组,仍然会存在问题。
以下这段代码在 JavaScript 中是没有问题的:
const obj = {
x: 1,
};
obj.x = 6;
obj.x = '6';
obj.y = 8;
obj.name = 'semlinker';
而在 TypeScript 中,对于 obj 的类型来说,它可以是 {readonly x:1} 类型,或者是更通用的 {x:number} 类型。当然也可能是 {[key: string]: number} 或 object 类型。对于对象,TypeScript 的拓宽算法会将其内部属性视为将其赋值给 let 关键字声明的变量,进而来推断其属性的类型。因此 obj 的类型为 {x:number} 。这使得你可以将 obj.x 赋值给其他 number 类型的变量,而不是 string 类型的变量,并且它还会阻止你添加其他属性。
因此最后三行的语句会出现错误:
const obj = {
x: 1,
};
obj.x = 6; // OK
// Type '"6"' is not assignable to type 'number'.
obj.x = '6'; // Error
// Property 'y' does not exist on type '{ x: number; }'.
obj.y = 8; // Error
// Property 'name' does not exist on type '{ x: number; }'.
obj.name = 'semlinker'; // Error
TypeScript 试图在具体性和灵活性之间取得平衡。它需要推断一个足够具体的类型来捕获错误,但又不能推断出错误的类型。它通过属性的初始化值来推断属性的类型,当然有几种方法可以覆盖 TypeScript 的默认行为。一种是提供显式类型注释:
// Type is { x: 1 | 3 | 5; }
const obj: { x: 1 | 3 | 5 } = {
x: 1
};
另一种方法是使用 const 断言。不要将其与 let 和 const 混淆,后者在值空间中引入符号。这是一个纯粹的类型级构造。让我们来看看以下变量的不同推断类型:
// Type is { x: number; y: number; }
const obj1 = {
x: 1,
y: 2
};
// Type is { x: 1; y: number; }
const obj2 = {
x: 1 as const,
y: 2,
};
// Type is { readonly x: 1; readonly y: 2; }
const obj3 = {
x: 1,
y: 2
} as const;
当你在一个值之后使用 const 断言时,TypeScript 将为它推断出最窄的类型,没有拓宽。对于真正的常量,这通常是你想要的。当然你也可以对数组使用 const 断言:
// Type is number[]
const arr1 = [1, 2, 3];
// Type is readonly [1, 2, 3]
const arr2 = [1, 2, 3] as const;
既然有类型拓宽,自然也会有类型缩小,下面我们简单介绍一下 Type Narrowing(类型缩小)。
5、类型缩小(Type Narrowing)
在 TypeScript 中,我们可以通过某些操作将变量的类型由一个较为宽泛的集合缩小到相对较小、较明确的集合,这就是 “Type Narrowing”。
比如,我们可以使用类型守卫(后面会讲到)将函数参数的类型从 any 缩小到明确的类型,具体示例如下:
{
let func = (anything: any) => {
if (typeof anything === 'string') {
return anything; // 类型是 string
} else if (typeof anything === 'number') {
return anything; // 类型是 number
}
return null;
};
}
在 VS Code 中 hover 到第 4 行的 anything 变量提示类型是 string,到第 6 行则提示类型是 number。
同样,我们可以使用类型守卫将联合类型缩小到明确的子类型,具体示例如下:
{
let func = (anything: string | number) => {
if (typeof anything === 'string') {
return anything; // 类型是 string
} else {
return anything; // 类型是 number
}
};
}
当然,我们也可以通过字面量类型等值判断(===)或其他控制流语句(包括但不限于 if、三目运算符、switch 分支)将联合类型收敛为更具体的类型,如下代码所示:
{
type Goods = 'pen' | 'pencil' |'ruler';
const getPenCost = (item: 'pen') => 2;
const getPencilCost = (item: 'pencil') => 4;
const getRulerCost = (item: 'ruler') => 6;
const getCost = (item: Goods) => {
if (item === 'pen') {
return getPenCost(item); // item => 'pen'
} else if (item === 'pencil') {
return getPencilCost(item); // item => 'pencil'
} else {
return getRulerCost(item); // item => 'ruler'
}
}
}
在上述 getCost 函数中,接受的参数类型是字面量类型的联合类型,函数内包含了 if 语句的 3 个流程分支,其中每个流程分支调用的函数的参数都是具体独立的字面量类型。
那为什么类型由多个字面量组成的变量 item 可以传值给仅接收单一特定字面量类型的函数 getPenCost、getPencilCost、getRulerCost 呢?这是因为在每个流程分支中,编译器知道流程分支中的 item 类型是什么。比如 item === ‘pencil’ 的分支,item 的类型就被收缩为“pencil”。
事实上,如果我们将上面的示例去掉中间的流程分支,编译器也可以推断出收敛后的类型,如下代码所示:
const getCost = (item: Goods) => {
if (item === 'pen') {
item; // item => 'pen'
} else {
item; // => 'pencil' | 'ruler'
}
}
一般来说 TypeScript 非常擅长通过条件来判别类型,但在处理一些特殊值时要特别注意 —— 它可能包含你不想要的东西!例如,以下从联合类型中排除 null 的方法是错误的:
const el = document.getElementById("foo"); // Type is HTMLElement | null
if (typeof el === "object") {
el; // Type is HTMLElement | null
}
因为在 JavaScript 中 typeof null 的结果是 “object” ,所以你实际上并没有通过这种检查排除 null 值。除此之外,falsy 的原始值也会产生类似的问题:
function foo(x?: number | string | null) {
if (!x) {
x; // Type is string | number | null | undefined\
}
}
因为空字符串和 0 都属于 falsy 值,所以在分支中 x 的类型可能是 string 或 number 类型。帮助类型检查器缩小类型的另一种常见方法是在它们上放置一个明确的 “标签”:
interface UploadEvent {
type: "upload";
filename: string;
contents: string;
}
interface DownloadEvent {
type: "download";
filename: string;
}
type AppEvent = UploadEvent | DownloadEvent;
function handleEvent(e: AppEvent) {
switch (e.type) {
case "download":
e; // Type is DownloadEvent
break;
case "upload":
e; // Type is UploadEvent
break;
}
}
这种模式也被称为 ”标签联合“ 或 ”可辨识联合“,它在 TypeScript 中的应用范围非常广。
六、联合类型
联合类型表示取值可以为多种类型中的一种,使用 | 分隔每个类型。 let styNum: string | number;
styNum = 'seven';
styNum = 7;
联合类型通常与 null 或 undefined 一起使用 const fn = (name:string | undefined)=>{ }
例如,这里 name 的类型是 string | undefined 意味着可以将 string 或 undefined 的值传递给fn 函数。 const fn = (name:string | undefined)=>{ }
fn('zs')
fn(undefined)
通过这个示例,你可以凭直觉知道类型 A 和类型 B 联合后的类型是同时接受 A 和 B 值的类型。此外,对于联合类型来说,你可能会遇到以下的用法: let num: 1 | 2 = 1;
type EventNames = 'click' | 'scroll' | 'mousemove';
以上示例中的 1、2 或 'click' 被称为字面量类型,用来约束取值只能是某几个值中的一个。
七、类型别名
类型别名用来给一个类型起个新名字。类型别名常用于联合类型。
type Message = string | string[]
let arr = (message:Message)=>{ }
注意:类型别名,诚如其名,即我们仅仅是给类型取了一个新的名字,并不是创建了一个新的类型。
八、交叉类型
交叉类型是将多个类型合并为一个类型。 这让我们可以把现有的多种类型叠加到一起成为一种类型,它包含了所需的所有类型的特性,使用&定义交叉类型。
type useLess = string & number
很显然,如果我们仅仅把原始类型、字面量类型、函数类型等原子类型合并成交叉类型,是没有任何用处的,因为任何类型都不能满足同时属于多种原子类型,比如既是 string 类型又是 number 类型。因此,在上述的代码中,类型别名 Useless 的类型就是个 never。
交叉类型真正的用武之地就是将多个接口类型合并成一个类型,从而实现等同接口继承的效果,也就是所谓的合并接口类型,如下代码所示:
type InterType = {
id: number;
name: string
} & {
age: number
}
const mixed: InterType = {
id: 1,
name: '张三',
age: 20
}
在上述示例中,我们通过交叉类型,使得 InterType同时拥有了 id、name、age 所有属性,这里我们可以试着将合并接口类型理解为求并集。
思考 这里,我们来发散思考一下:如果合并的多个接口类型存在同名属性会是什么效果呢? 如果同名属性的类型不兼容,比如上面示例中两个接口类型同名的 name 属性类型一个是 number,另一个是 string,合并后,name 属性的类型就是 number 和 string 两个原子类型的交叉类型,即 never,如下代码所示: type IntersectionTypeConfict = { id: number; name: string; }
& { age: number; name: number; };
const mixedConflict: IntersectionTypeConfict = {
id: 1,
name: 2, // ts(2322) 错误,'number' 类型不能赋给 'never' 类型
age: 2
};
此时,我们赋予 mixedConflict 任意类型的 name 属性值都会提示类型错误。而如果我们不设置 name 属性,又会提示一个缺少必选的 name 属性的错误。在这种情况下,就意味着上述代码中交叉出来的 IntersectionTypeConfict 类型是一个无用类型。 如果同名属性的类型兼容,比如一个是 number,另一个是 number 的子类型、数字字面量类型,合并后 name 属性的类型就是两者中的子类型。 如下所示示例中 name 属性的类型就是数字字面量类型 2,因此,我们不能把任何非 2 之外的值赋予 name 属性。 type IntersectionTypeConfict = { id: number; name: 2; }
& { age: number; name: number; };
let mixedConflict: IntersectionTypeConfict = {
id: 1,
name: 2, // ok
age: 2
};
mixedConflict = {
id: 1,
name: 22, // '22' 类型不能赋给 '2' 类型
age: 2
};
那么如果同名属性是非基本数据类型的话,又会是什么情形。我们来看个具体的例子: interface A {
x:{d:true},
}
interface B {
x:{e:string},
}
interface C {
x:{f:number},
}
type ABC = A & B & C
let abc:ABC = {
x:{
d:true,
e:'',
f:666
}
}
以上代码成功运行后,会输出以下结果: { x: { d: true , e: "" , f: 666}}
由上可知,在混入多个类型时,若存在相同的成员,且成员类型为非基本数据类型,那么是可以成功合并。
九、接口(interface)
在 TypeScript 中,我们使用接口(Interfaces)来定义对象的类型。
1、示例
interface Person {
name: string,
age: number
}
let obj: Person = {
name: '张三',
age: 20
}
上面的例子中,我们定义了一个接口 Person,接着定义了一个变量 name,它的类型是 Person。这样,我们就约束了 name 的形状必须和接口 Person 一致。
注意:
接口一般首字母大写。定义的变量比接口少了一些属性是不允许的多一些属性也是不允许的
2、可选 | 只读属性
readonly(只读)变量后跟 ?(可选)
interface Person {
readonly name: string, // 只读属性,不能修改
age?: number // 可选,在使用时可写可不写
}
let obj: Person = {
name: '张三',
age: 20
}
只读属性用于限制只能在对象刚刚创建的时候修改其值。此外 TypeScript 还提供了 ReadonlyArray
let a: number[] = [1, 2, 3, 4];
let ro: ReadonlyArray
ro[0] = 12; // 类型“readonly number[]”中的索引签名仅允许读取
ro.push(5); // 类型“readonly number[]”上不存在属性“push”
ro.length = 100; // 无法为“length”赋值,因为它是只读属性
a = ro; // 类型 "readonly number[]" 为 "readonly",不能分配给可变类型 "number[]"
3、任意属性
有时候我们希望一个接口中除了包含必选和可选属性之外,还允许有其他的任意属性,这时我们可以使用 索引签名 的形式来满足上述要求。
interface Person {
name: string,
age?: number,
[gender: string]: any
}
let userInfo:Person = {
name: '张三',
gender: '男'
}
注意:一旦定义了任意属性,那么确定属性和可选属性的类型都必须是它的类型的子集
interface Person {
name: string,
age?: number, // 类型“number | undefined”的属性“age”不能赋给“string”索引类型“string”
[gender: string]: string
}
// 不能将类型“{ name: string; age: number; gender: string; }”分配给类型“Person”。属性“age”与索引签名不兼容
let userInfo: Person = {
name: '张三',
age: 20,
gender: '男'
}
上例中,任意属性的值允许是 string,但是可选属性 age 的值却是 number,number 不是 string 的子属性,所以报错了。
另外,在报错信息中可以看出,此时 { name: '张三', age: 20, gender: '男' } 的类型被推断成了 { [x: string]: string | number; name: string; age: number; gender: string; },这是联合类型和接口的结合。
# 一个接口中只能定义一个任意属性。如果接口中有多个类型的属性,则可以在任意属性中使用联合类型:
interface Person {
name: string;
age?: number; // 这里真实的类型应该为:number | undefined
[propName: string]: string | number | undefined;
}
let tom: Person = {
name: '张三',
age: 20,
gender: '男'
};
4、鸭式辨型法
所谓的鸭式辨型法就是像鸭子一样走路并且嘎嘎叫的就叫鸭子,即具有鸭子特征的认为它就是鸭子,也就是通过制定规则来判定对象是否实现这个接口。
代码 interface LabeleValue {
lable: string
}
function printLable(lableObj: LabeleValue){
console.log(lableObj.lable);
}
let obj = {
size: 10,
lable: '我是lable'
}
interface LabeleValue {
lable: string
}
function printLable(lableObj: LabeleValue) {
console.log(lableObj.lable);
}
printLable({ size: 10, lable: "我是lable" }); // 对象字面量只能指定已知属性,并且“size”不在类型“LabeleValue”中。
上面代码,在参数里写对象就相当于是直接给lableObj赋值,这个对象有严格的类型定义,所以不能多参或少参。而当你在外面将该对象用另一个变量obj接收,obj不会经过额外属性检查,但会根据类型推论为let obj: { size: number; label: string } = { size: 10, label: "我是lable" };,然后将这个obj再赋值给lableObj,此时根据类型的兼容性,两种类型对象,参照鸭式辨型法,因为都具有label属性,所以被认定为两个相同,故而可以用此法来绕开多余的类型检查。
5、绕开额外属性检查的方式
鸭式辨型法 如上例子所示 类型断言 类型断言的意义就等同于你在告诉程序,你很清楚自己在做什么,此时程序自然就不会再进行额外的属性检查了。 interface Props {
name: string,
age: number,
gender?: string
}
let obj: Props = {
name: '张三',
age: 25,
gender: '男',
girl: false // 如果不加类型断言(as Props),会提示: 对象字面量只能指定已知属性,并且“girl”不在类型“Props”中
} as Props // 通过静态代码分析
索引签名 interface Props {
name: string,
age: number,
gender?: string,
[key:string]:any // 索引签名
}
let obj: Props = {
name: '张三',
age: 25,
}
十、接口类型别名的区别
实际上,在大多数的情况下使用接口类型和类型别名的效果等价,但是在某些特定的场景下这两者还是存在很大区别。
TypeScript 的核心原则之一是对值所具有的结构进行类型检查。 而接口的作用就是为这些类型命名和为你的代码或第三方代码定义数据模型。
type(类型别名)会给一个类型起个新名字。 type 有时和 interface 很像,但是可以作用于原始值(基本类型),联合类型,元组以及其它任何你需要手写的类型。起别名不会新建一个类型 - 它创建了一个新 名字来引用那个类型。给基本类型起别名通常没什么用,尽管可以做为文档的一种形式使用。
1、描述对象、函数
两者都可以用来描述对象或函数的类型,但是语法不同。
interface Props {
x:number,
y:string
}
interface SetProps {
(x:number,y:number):void
}
type Props = {
x: number,
y: string
}
type SetProps = (x: number, y: string) => void
2、其他类型 - Other Types
与接口不同,类型别名还可以用于其他类型,如基本类型(原始值)、联合类型、元组。
// 基本类型 - primitive
type name = string
// 对象 - Object
type PersonX = { x: number }
type PersonY = { y: number }
// 联合类型 - union
type PertialPoint = PersonX | PersonY
// 元组 - tuple
type data = [number, string]
// 节点 - dom
let div = document.querySelector('div')
type B = typeof div
3、接口可以定义多次,类型别名不可以
与类型别名不同,接口可以定义多次,会被自动合并为单个接口。
interface Point {
x: number
}
interface Point {
y: string
}
const pointObj: Point = {
x: 1,
y: '2'
}
4、接口与类型别名扩展
两者的扩展方式不同,但并不互斥。接口可以扩展类型别名,同理,类型别名也可以扩展接口。
接口的扩展就是继承,通过 extends 来实现。类型别名的扩展就是交叉类型,通过 & 来实现。
接口扩展接口 interface pointX {
x:number
}
interface pointY extends pointX{
y:string
}
类型别名扩展类型别名 type PointX = {
x: number
}
type PointY = PointX & {
y: string
}
接口扩展类型别名 type PointX = {
x: number
}
interface PointY extends PointX {
y: string
}
类型别名扩展接口 interface PointX {
x: number
}
type PointY = PointX & {
y: string
}
十一、泛型
1、泛型介绍
实现一个函数 identity,函数的参数可以是任何值,返回值就是将参数原样返回,并且其只能接受一个参数,怎么做?
const identity = (arg) => arg;
由于其可以接受任意值,也就是说函数的入参和返回值都应该可以是任意类型。 现在给代码增加类型声明:
type idBoolean = (arg: boolean) => boolean;
type idNumber = (arg: number) => number;
type idString = (arg: string) => string;
...
上述方法就是一个笨方法,就是说 JS 提供多少种类型,就需要复制多少份代码,然后改下类型签名。这对程序员来说是致命的。这种复制粘贴增加了出错的概率,使得代码难以维护,牵一发而动全身。并且将来 JS 新增新的类型,你仍然需要修改代码,也就是说你的代码对修改开放,这样不好。还有一种方式是使用 any 这种“万能语法”。但是也有缺点:
identity("string").length; // ok
identity("string").toFixed(2); // ok
identity(null).toString(); // ok
如果使用 any 的话,怎么写都是 ok 的, 这就丧失了类型检查的效果。实际上我知道我传给你的是 string,返回来的也一定是 string,而 string 上没有 toFixed 方法,因此需要报错才是我想要的。也就是说我真正想要的效果是:当我用到id的时候,你根据我传给你的类型进行推导。比如我传入的是 string,但是使用了 number 上的方法,你就应该报错。
为了解决上面的这些问题,就可以使用泛型对上面的代码进行重构。和定义不同,这里用了一个 类型 T,这个 T 是一个抽象类型,只有在调用的时候才确定它的值,这就不用我们复制粘贴无数份代码了。
function identity
return arg;
}
其中 T 代表 Type,在定义泛型时通常用作第一个类型变量名称。但实际上 T 可以用任何有效名称代替。除了 T 之外,以下是常见泛型变量代表的意思:
K(Key):表示对象中的键类型;V(Value):表示对象中的值类型;E(Element):表示元素类型。
其实并不是只能定义一个类型变量,我们可以引入希望定义的任何数量的类型变量。比如我们引入一个新的类型变量 U,用于扩展我们定义的 identity 函数:
// const identity=
// return value
// }
function identity
return value
}
console.log(identity
除了为类型变量显式设定值之外,一种更常见的做法是使编译器自动选择这些类型,从而使代码更简洁。我们可以完全省略尖括号,比如:
function identity
return value
}
console.log(identity(68, "Semlinker"));
// 对于上述代码,编译器足够聪明,能够知道我们的参数类型,并将它们赋值给 T 和 U,而不需要开发人员显式指定它们。
2、泛型约束
假如我想打印出参数的 size 属性呢?如果完全不进行约束 TS 是会报错的:
const trace =
console.log(arg.size); // 类型“T”上不存在属性“size”
return arg
}
报错的原因在于 T 理论上是可以是任何类型的,不同于 any,你不管使用它的什么属性或者方法都会报错(除非这个属性和方法是所有集合共有的)。那么直观的想法是限定传给 trace 函数的参数类型应该有 size 类型,这样就不会报错了。如何去表达这个类型约束的点呢?实现这个需求的关键在于使用类型约束。 使用 extends 关键字可以做到这一点。简单来说就是你定义一个类型,然后让 T 实现这个接口即可。
interface SizeBle {
size: number
}
const trace =
console.log(arg.size); // 类型“T”上不存在属性“size”
return arg
}
3、泛型工具类型
PS:以下为TypeScript 内置的工具类型,难度提升
为了方便开发者 TypeScript 内置了一些常用的工具类型,比如 Partial、Required、Readonly、Record 和 ReturnType 等。不过在具体介绍之前,我们得先介绍一些相关的基础知识,方便读者可以更好的学习其它的工具类型。
1.typeof
typeof 的主要用途是在类型上下文中获取变量或者属性的类型,下面通过一个具体示例来理解一下。
interface Person {
name: string
age: number
}
const sem: Person = {
name: '222',
age: 20
}
type Sem = typeof sem
在上面代码中,我们通过 `typeof` 操作符获取 sem 变量的类型并赋值给 Sem 类型变量,之后我们就可以使用 Sem 类型
const lolo: Sem = { name: "lolo", age: 5 }
也可以对嵌套对象执行相同的操作:
const messageObj = {
id: 1,
name: '小王',
address: {
province: '四川',
city: '成都'
}
}
type message = typeof messageObj;
const Obj: message = {
id: 1,
name: '小王',
address: {
province: '四川',
city: '成都'
}
}
此外,typeof 操作符除了可以获取对象的结构类型之外,它也可以用来获取函数对象的类型,比如:
const toArray = (x:number) :Array
return [10]
}
type funType = typeof toArray
const fn:funType = ()=>{
return [10,20,30]
}
2.keyof
keyof 操作符是在 TypeScript 2.1 版本引入的,该操作符可以用于获取某种类型的所有键,其返回类型是联合类型。
interface Person {
name: string,
age: number
}
type K1 = keyof Person; // "name" | "age"
type K2 = keyof Person[]; // "length" | "toString" | "pop" | "push" | "concat" | "join"
type K3 = keyof { [x: string]: Person }; // string | number
在 TypeScript 中支持两种索引签名,数字索引和字符串索引:
interface StringArray {
// 字符串索引 -> keyof StringArray => string | number
[index: string]: string;
}
interface StringArray1 {
// 数字索引 -> keyof StringArray1 => number
[index: number]: string;
}
为了同时支持两种索引类型,就得要求数字索引的返回值必须是字符串索引返回值的子类。其中的原因就是当使用数值索引时,JavaScript 在执行索引操作时,会先把数值索引先转换为字符串索引。所以 keyof { [x: string]: Person } 的结果会返回 string | number。
keyof也支持基本数据类型:
let K1: keyof boolean; // let K1: "valueOf"
let K2: keyof number; // let K2: "toString" | "toFixed" | "toExponential" | ...
let K3: keyof symbol; // let K1: "valueOf"
keyof 的作用
JavaScript 是一种高度动态的语言。有时在静态类型系统中捕获某些操作的语义可能会很棘手。以一个简单的prop 函数为例: function prop(obj, key) {
return obj[key];
}
函数接收 obj 和 key 两个参数,并返回对应属性的值。对象上的不同属性,可以具有完全不同的类型,我们甚至不知道 obj 对象长什么样。 那么在 TypeScript 中如何定义上面的 prop 函数呢?我们来尝试一下: function prop(obj: object, key: string) {
return obj[key];
}
在上面代码中,为了避免调用 prop 函数时传入错误的参数类型,我们为 obj 和 key 参数设置了类型,分别为 {} 和 string 类型。然而,事情并没有那么简单。针对上述的代码,TypeScript 编译器会输出以下错误信息: // 元素隐式具有 "any" 类型,因为类型为 "string" 的表达式不能用于索引类型 "{}"。
// 在类型 "{}" 上找不到具有类型为 "string" 的参数的索引签名。
元素隐式地拥有 any 类型,因为 string 类型不能被用于索引 {} 类型。要解决这个问题,你可以使用以下非常暴力的方案: function prop(obj: object, key: string) {
return (obj as any)[key];
}
很明显该方案并不是一个好的方案,我们来回顾一下 prop 函数的作用,该函数用于获取某个对象中指定属性的属性值。因此我们期望用户输入的属性是对象上已存在的属性,那么如何限制属性名的范围呢?这时我们可以利用本文的主角 keyof 操作符: function prop
return obj[key];
}
在以上代码中,我们使用了 TypeScript 的泛型和泛型约束。首先定义了 T 类型并使用 extends 关键字约束该类型必须是 object 类型的子类型,然后使用 keyof 操作符获取 T 类型的所有键,其返回类型是联合类型,最后利用 extends 关键字约束 K 类型必须为 keyof T 联合类型的子类型。 是骡子是马拉出来遛遛就知道了,我们来实际测试一下: type Todo = {
id: number,
name: string,
done: boolean
}
const todo: Todo = {
id: 1,
name: '999',
done: true
}
function prop
return obj[key]
}
const id = prop(todo,"id") // const id: number
const name = prop(todo,"name") // const id: string
const done = prop(todo,"done") // const id: boolean
很明显使用泛型,重新定义后的 prop
对于上述代码,TypeScript 编译器会提示以下错误:
// 类型“"date"”的参数不能赋给类型“keyof Todo”的参数
这就阻止我们尝试读取不存在的属性。
3.in
in 用来遍历枚举类型:
type Keys = "a" | "b" | "c"
type obj = {
[p in Keys]: any // type obj = { a: any; b: any;c: any;}
}
4.infer
在条件类型语句中,可以用 infer 声明一个类型变量并且对它进行使用。
type ReturnType
...args: any[]
) => infer R ? R : any
以上代码中 infer R 就是声明一个变量来承载传入函数签名的返回值类型,简单说就是用它取到函数返回值的类型方便之后使用。
5.extends
有时候我们定义的泛型不想过于灵活或者说想继承某些类等,可以通过 extends 关键字添加泛型约束。
interface Lengthwise {
length: number
}
function loggingIdentity
console.log(arg.length);
return arg
}
现在这个泛型函数被定义了约束,因此它不再是适用于任意类型:
loggingIdentity(10) // 类型“number”的参数不能赋给类型“Lengthwise”的参数
这时我们需要传入符合约束类型的值,必须包含length属性:
loggingIdentity({ length: 10, size: 'large' })
6.索引类型
在实际开发中,我们经常能遇到这样的场景,在对象中获取一些属性的值,然后建立对应的集合。
let person = {
name: 'XXX',
age: 25
}
const getValue = (person: any, keys: string[]) => {
return keys.map(item => person[item])
}
console.log(getValue(person,['name','age'])) // ['XXX', 25]
console.log(getValue(person,['gender'])) // undefined
在上述代码中,可以看到getValue(person, [‘gender’])打印出来的是 undefined ,但是ts编译器并没有给出报错信息,那么如何使用ts对这种模式进行类型约束呢?这里就要用到了索引类型,改造一下getValue函数,通过 索引类型查询和 索引访问 操作符:
interface Person {
name: string,
age: number
}
let person:Person = {
name: 'XXX',
age: 25
}
const getValue =
return keys.map(item => person[item])
}
getValue(person,['name']) // success
getValue(person,['gender']) // 不能将类型“"gender"”分配给类型“keyof Person”
编译器会检查传入的值是否是Person的一部分。通过下面的概念来理解上面的代码:
// T[K]表示对象T的属性K所表示的类型,在上述例子中,T[K][] 表示变量T取属性K的值的数组
// 通过[]索引类型访问操作符, 我们就能得到某个索引的类型
class Person {
name:string;
age:number;
}
type MyType = Person['name']; //Person中name的类型为string type MyType = string
介绍完概念之后,应该就可以理解上面的代码了。首先看泛型,这里有T和K两种类型,根据类型推断,第一个参数person就是person,类型会被推断为Person。而第二个数组参数的类型推断(K extends keyof T),keyof关键字可以获取T,也就是Person的所有属性名,即[‘name’, ‘age’]。而extends关键字让泛型K继承了Person的所有属性名,即[‘name’, ‘age’]。这三个特性组合保证了代码的动态性和准确性,也让代码提示变得更加丰富了
7.映射类型
根据旧的类型创建出新的类型, 我们称之为映射类型
示例
// 定义一个接口
interface TestInterface {
name: string,
age: number
}
// 把定义的接口里面的属性全部变成可选
// 可以通过+/-来指定添加还是删除
interface TestInterface {
name: string,
age: number
}
type optionalTestInterface
[p in keyof T]+?: T[p]
}
type newTestInterface = optionalTestInterface
// 比如我们再加上只读
interface TestInterface {
name: string,
age: number
}
type optionalTestInterface
+readonly [p in keyof T]+?: T[p]
}
type newTestInterface = optionalTestInterface
由于生成只读属性和可选属性比较常用, 所以TS内部已经给提供了现成的实现 Readonly / Partial。
8.partial
Partial
定义
type Partial
[P in keyof T]?: T[P]
}
在以上代码中,首先通过 keyof T 拿到 T 的所有属性名,然后使用 in 进行遍历,将值赋给 P,最后通过 T[P] 取得相应的属性值的类。中间的 ? 号,用于将所有属性变为可选。
举例说明
interface UserInfo {
id: number,
name: string
}
// 类型 "{ name: string; }" 中缺少属性 "id"
const xiaoming:NewUserInfo = {
name:'小明'
}
// 使用 Partial
type NewUserInfo = Partial
// 这个 NewUserInfo 就相当于
interface NewUserInfo {
id?: string;
name?: string;
}
注意: Partial
interface UserInfo {
id: number,
name: string,
fruits: {
appleNumber: number,
orangeNumber: number
}
}
type NewUserInfo = Partial
// 类型 "{ orangeNumber: number; }" 中缺少属性 "appleNumber",但类型 "{ appleNumber: number; orangeNumber: number; }" 中需要该属性。
const xiaoming: NewUserInfo = {
name: '小明',
fruits: {
orangeNumber: 10
}
}
可以看到,第二层以后就不会处理了,如果要处理多层,就可以自己实现。
DeepPartial type DeepPartial
// 如果是 object,则递归类型
[U in keyof T]?: T[U] extends object
? DeepPartial
: T[U]
};
type PartialedWindow = DeepPartial
9.Required
Required将类型的属性变成必选
定义
type Required
[P in keyof T]-?: T[P]
}
其中 -? 是代表移除 ? 这个 modifier 的标识。再拓展一下,除了可以应用于 ? 这个 modifiers ,还有应用在 readonly ,比如 Readonly
type Readonly
readonly [p in keyof T]: T[p]
}
10.Readonly
Readonly
定义
type Readonly
readonly [P in keyof T] : T[P]
}
举例说明
interface Todo {
title:string
}
const todo:Readonly
title:'this is title'
}
todo.title = 'Hello' // 无法为“title”赋值,因为它是只读属性。
11.Pick
Pick 从某个类型中挑出一些属性出来
定义
type Pick
[P in K]:T[P]
}
举例说明
interface Todo {
title: string,
decipher: string,
completed: boolean
}
type TodoPreview = Pick
const todo: TodoPreview = {
title: 'this is Pick',
completed: false
}
12.Record
Record
定义
type Record
[P in K]: T
}
举例说明
interface PageInfo {
title: string;
}
type Page = "home" | "about" | "contact";
const x: Record
about: { title: "about" },
contact: { title: "contact" },
home: { title: "home" },
};
13.ReturnType
用来得到一个函数的返回值类型
定义
type ReturnType
...args: any[]
) => infer R
? R
: any;
// infer在这里用于提取函数类型的返回值类型。ReturnType
举例说明
type Func = (value: number) => string;
const foo: ReturnType
// ReturnType获取到 Func 的返回值类型为 string,所以,foo 也就只能被赋值为字符串了。
14.Exclude
Exclude
定义
type Exclude
// 如果 T 能赋值给 U 类型的话,那么就会返回 never 类型,否则返回 T 类型。最终实现的效果就是将 T 中某些属于 U 的类型移除掉。
举例说明
type T0 = Exclude<"a" | "b" | "c", "a">; // "b" | "c"
type T1 = Exclude<"a" | "b" | "c", "a" | "b">; // "c"
type T2 = Exclude
15.Extract
Extract
定义
type Extract
举例说明
type T0 = Extract<"a" | "b" | "c", "a" | "f">; // "a"
type T1 = Extract
16.Omit
Omit
定义
type Omit
举例说明
interface Todo {
title: string;
description: string;
completed: boolean;
}
type TodoPreview = Omit
const todo: TodoPreview = {
title: "Clean room",
completed: false,
};
17.NonNullable
NonNullable
定义
type NonNullable
举例说明
type T0 = NonNullable
type T1 = NonNullable
18.Parameters
Parameters
定义
type Parameters
? P : never;
举例说明
type A = Parameters<() =>void>; // []
type B = Parameters
type C = Parameters
type D = Parameters
十二、tsconfig.json
1、tsconfig.json介绍
tsconfig.json 是 TypeScript 项目的配置文件。如果一个目录下存在一个 tsconfig.json 文件,那么往往意味着这个目录就是 TypeScript 项目的根目录。
tsconfig.json 包含 TypeScript 编译的相关配置,通过更改编译配置项,我们可以让 TypeScript 编译出 ES6、ES5、node 的代码。
2、tsconfig.json 重要字段
files - 设置要编译的文件的名称include - 设置需要进行编译的文件,支持路径模式匹配exclude - 设置无需进行编译的文件,支持路径模式匹配compilerOptions - 设置与编译流程相关的选项
3、compilerOptions 选项
{
"compilerOptions": {
/* 基本选项 */
"target": "es5", // 指定 ECMAScript 目标版本: 'ES3' (default), 'ES5', 'ES6'/'ES2015', 'ES2016', 'ES2017', or 'ESNEXT'
"module": "commonjs", // 指定使用模块: 'commonjs', 'amd', 'system', 'umd' or 'es2015'
"lib": [], // 指定要包含在编译中的库文件
"allowJs": true, // 允许编译 javascript 文件
"checkJs": true, // 报告 javascript 文件中的错误
"jsx": "preserve", // 指定 jsx 代码的生成: 'preserve', 'react-native', or 'react'
"declaration": true, // 生成相应的 '.d.ts' 文件
"sourceMap": true, // 生成相应的 '.map' 文件
"outFile": "./", // 将输出文件合并为一个文件
"outDir": "./", // 指定输出目录
"rootDir": "./", // 用来控制输出目录结构 --outDir.
"removeComments": true, // 删除编译后的所有的注释
"noEmit": true, // 不生成输出文件
"importHelpers": true, // 从 tslib 导入辅助工具函数
"isolatedModules": true, // 将每个文件做为单独的模块 (与 'ts.transpileModule' 类似).
/* 严格的类型检查选项 */
"strict": true, // 启用所有严格类型检查选项
"noImplicitAny": true, // 在表达式和声明上有隐含的 any类型时报错
"strictNullChecks": true, // 启用严格的 null 检查
"noImplicitThis": true, // 当 this 表达式值为 any 类型的时候,生成一个错误
"alwaysStrict": true, // 以严格模式检查每个模块,并在每个文件里加入 'use strict'
/* 额外的检查 */
"noUnusedLocals": true, // 有未使用的变量时,抛出错误
"noUnusedParameters": true, // 有未使用的参数时,抛出错误
"noImplicitReturns": true, // 并不是所有函数里的代码都有返回值时,抛出错误
"noFallthroughCasesInSwitch": true, // 报告 switch 语句的 fallthrough 错误。(即,不允许 switch 的 case 语句贯穿)
/* 模块解析选项 */
"moduleResolution": "node", // 选择模块解析策略: 'node' (Node.js) or 'classic' (TypeScript pre-1.6)
"baseUrl": "./", // 用于解析非相对模块名称的基目录
"paths": {}, // 模块名到基于 baseUrl 的路径映射的列表
"rootDirs": [], // 根文件夹列表,其组合内容表示项目运行时的结构内容
"typeRoots": [], // 包含类型声明的文件列表
"types": [], // 需要包含的类型声明文件名列表
"allowSyntheticDefaultImports": true, // 允许从没有设置默认导出的模块中默认导入。
/* Source Map Options */
"sourceRoot": "./", // 指定调试器应该找到 TypeScript 文件而不是源文件的位置
"mapRoot": "./", // 指定调试器应该找到映射文件而不是生成文件的位置
"inlineSourceMap": true, // 生成单个 soucemaps 文件,而不是将 sourcemaps 生成不同的文件
"inlineSources": true, // 将代码与 sourcemaps 生成到一个文件中,要求同时设置了 --inlineSourceMap 或 --sourceMap 属性
/* 其他选项 */
"experimentalDecorators": true, // 启用装饰器
"emitDecoratorMetadata": true // 为装饰器提供元数据的支持
}
}
十三、编写高效 TS 代码的一些建议
1、尽量减少重复代码
对于刚接触 TypeScript 的小伙伴来说,在定义接口时,可能一不小心会出现以下类似的重复代码。比如:
interface Person {
firstName: string;
lastName: string;
}
interface PersonWithBirthDate {
firstName: string;
lastName: string;
birth: Date;
}
很明显,相对于 Person 接口来说,PersonWithBirthDate 接口只是多了一个 birth 属性,其他的属性跟 Person 接口是一样的。那么如何避免出现例子中的重复代码呢?要解决这个问题,可以利用 extends 关键字:
interface Person {
firstName: string;
lastName: string;
}
interface PersonWithBirthDate extends Person {
birth: Date;
}
当然除了使用 extends 关键字之外,也可以使用交叉运算符(&):
type PersonWithBirthDate = Person & { birth: number }
另外,有时候你可能还会发现自己想要定义一个类型来匹配一个初始配置对象的「形状」,比如:
const INIT_OPTIONS = {
width: 640,
height: 480,
color: "#00FF00",
label: "VGA",
};
interface Options {
width: number;
height: number;
color: string;
label: string;
}
其实,对于 Options 接口来说,你也可以使用 typeof 操作符来快速获取配置对象的「形状」:
const INIT_OPTIONS = {
width: 640,
height: 480,
color: "#00FF00",
label: "VGA",
};
type Options = typeof INIT_OPTIONS;
在实际的开发过程中,重复的类型并不总是那么容易被发现。有时它们会被语法所掩盖。比如有多个函数拥有相同的类型签名:
function get(url: string, opts: Options): Promise
function post(url: string, opts: Options): Promise
对于上面的 get 和 post 方法,为了避免重复的代码,你可以提取统一的类型签名:
const INIT_OPTIONS = {
width: 640,
height: 480,
color: "#00FF00",
label: "VGA",
};
type Options = typeof INIT_OPTIONS;
type HTTPFunction = (url: string, opts: Options) => Promise
const getFn:HTTPFunction = (url,opts)=>{
return new Promise(()=>{ /*......*/ })
}
2、使用更精确的类型替代字符串类型
假设你正在构建一个音乐集,并希望为专辑定义一个类型。这时你可以使用 interface 关键字来定义一个 Album 类型:
interface Album {
artist: string; // 艺术家
title: string; // 专辑标题
releaseDate: string; // 发行日期:YYYY-MM-DD
recordingType: string; // 录制类型:"live" 或 "studio"
}
对于 Album 类型,你希望 releaseDate 属性值的格式为 YYYY-MM-DD,而 recordingType 属性值的范围为 live 或 studio。但因为接口中 releaseDate 和 recordingType 属性的类型都是字符串,所以在使用 Album 接口时,可能会出现以下问题:
const dangerous: Album = {
artist: "Michael Jackson",
title: "Dangerous",
releaseDate: "November 31, 1991", // 与预期格式不匹配
recordingType: "Studio", // 与预期格式不匹配
};
虽然 releaseDate 和 recordingType 的值与预期的格式不匹配,但此时 TypeScript 编译器并不能发现该问题。为了解决这个问题,你应该为 releaseDate 和 recordingType 属性定义更精确的类型,比如这样:
interface Album {
artist: string; // 艺术家
title: string; // 专辑标题
releaseDate: Date; // 发行日期:YYYY-MM-DD
recordingType: "studio" | "live"; // 录制类型:"live" 或 "studio"
}
重新定义 Album 接口之后,对于前面的赋值语句,TypeScript 编译器就会提示以下异常信息:
const dangerous: Album = {
artist: "Michael Jackson",
title: "Dangerous",
releaseDate: "November 31, 1991", // 不能将类型“string”分配给类型“Date”
recordingType: "Studio", // 不能将类型“"Studio"”分配给类型“"studio" | "live"”
};
为了解决上面的问题,你需要为 releaseDate 和 recordingType 属性设置正确的类型,比如这样:
const dangerous: Album = {
artist: "Michael Jackson",
title: "Dangerous",
releaseDate: new Date('2000-01-01'),
recordingType: "studio"
};
3、定义的类型总是表示有效的状态
假设你正在构建一个允许用户指定页码,然后加载并显示该页面对应内容的 Web 应用程序。首先,你可能会先定义 State 对象:
interface State {
pageSize: string,
loading: boolean,
errMsg?: string
}
接着你会定义一个 renderPage 函数,用来渲染页面:
const renderPage = (state: State) => {
if (state.errMsg) {
return `呜呜呜,加载页面出现异常了...${state.errMsg}`;
} else if (state.loading) {
return `页面加载中~~~`;
}
return `
}
console.log(renderPage({loading: true, pageCount: ""})); // 打印:页面加载中~~~
console.log(renderPage({loading: false, pageCount: "大家好呀"})); // 打印:
继续定义一个 changePage 函数,用于根据页码获取对应的页面数据:
const getUrlPage = (page: string) => {
return '222'
}
const changePage = async (state: State, newPage: string) => {
state.loading = true
try {
const response = await fetch(getUrlPage(newPage))
if (!response.ok) {
throw new Error(`Unable to load ${newPage}: ${response.statusText}`)
}
const text = await response.text()
state.loading = false
state.pageCount = text
} catch (e) {
state.errMsg = "" + e
}
}
对于以上的 changePage 函数,它存在以下问题:
在 catch 语句中,未把 state.loading 的状态设置为 false;未及时清理 state.errMsg 的值,因此如果之前的请求失败,那么你将继续看到错误消息,而不是加载消息。
出现上述问题的原因是,前面定义的 State 类型允许同时设置 loading 和 errMsg 的值,尽管这是一种无效的状态。针对这个问题,可以考虑引入可辨识联合类型来定义不同的页面请求状态:
interface RequestPending {
state: "pending";
}
interface RequestError {
state: "error";
errorMsg: string;
}
interface RequestSuccess {
state: "ok";
pageContent: string;
}
type RequestState = RequestPending | RequestError | RequestSuccess;
interface State {
currentPage: string;
requests: { [page: string]: RequestState };
}
在以上代码中,通过使用可辨识联合类型分别定义了 3 种不同的请求状态,这样就可以很容易的区分出不同的请求状态,从而让业务逻辑处理更加清晰。接下来,需要基于更新后的 State 类型,来分别更新一下前面创建的 renderPage 和 changePage 函数:
更新后的 renderPage 函数
const renderPage = (state: State) => {
const { currentPage } = state;
const requestState = state.requests[currentPage];
switch (requestState.state) {
case "pending":
return `页面加载中~~~`;
case "error":
return `呜呜呜,加载第${currentPage}页出现异常了...${requestState.errorMsg}`;
case "ok":
`
}
}
更新后的 changePage 函数
const changePage = async (state: State, newPage: string) => {
state.requests[newPage] = { state: "pending" };
state.currentPage = newPage;
try {
const response = await fetch(getUrlForPage(newPage));
if (!response.ok) {
throw new Error(`无法正常加载页面 ${newPage}: ${response.statusText}`);
}
const pageContent = await response.text();
state.requests[newPage] = { state: "ok", pageContent };
} catch (e) {
state.requests[newPage] = { state: "error", errorMsg: "" + e };
}
}
const getUrlForPage = (page: string) => {
return '100'
}
在 changePage 函数中,会根据不同的情形设置不同的请求状态,而不同的请求状态会包含不同的信息。这样 renderPage 函数就可以根据统一的 state 属性值来进行相应的处理。因此,通过使用可辨识联合类型,让请求的每种状态都是有效的状态,不会出现无效状态的问题。
相关阅读
发表评论