TypeScript介绍
-
TypeScript是JS的超集, TS提供了 JS的所有功能, 并且额外增加了
类型系统- 所有的JS代码都是TS代码
JS有类型(比如number/string等),但是JS不会检查变量的类型是否发生变化,而TS会检查
-
TypeScript类型系统的主要优势: 可以显式标记出代码中的意外行为,从而降低发生错误的可能性
可以将TS中的常用基础类型细分为两类: 1、JS已有类型 2、TS新增类型
1、JS已有类型
- 原始类型: number/string/boolean/null/undefined/symbol
- 对象类型:object(包括对象、数组、函数等对象)
2、TS新增类型
- 联合类型、自定义类型(类型别名)、接口、元组、字面量类型、枚举、void、any等
- 注意:原始类型在TS和JS中写法一致;对象类型在TS中更加细化,每个具体的对象(数组、对象、函数)都有自己的类型语法
TypeScript常用类型
原始类型: number/string/boolean/null/undefined/symbol
特点:简单,这些类型,完全按照 JS 中类型的名称来书写
let name: string = '蝈蝈';
let age: number = 27;
let isMarried: boolean = false;
let aa: null = null;
let bb: undefined = undefined;
// 特殊:Symbol() 创建的值是唯一的
// 作用:可以作为对象属性的键,防止与对象中其他键冲突
let obj = {
a: '123'
}
// 为 obj 对象添加属性,并且还要保证属性名一定不会重复
let uniqKey: symbol = Symbol()
obj[uniqKey] = ''
// 取值:
console.log( obj[uniqKey] )
数组类型
数组类型有以下两种写法,推荐使用 number[] 写法
// 写法一 推荐
let arr: number[] = [1,2,3]
// 写法二
let arr: Array<string> = ['1', '2', '3']
联合类型
'|'竖线在TS中叫做联合类型,即:由两个或多个其他类型组成的类型,表示可以是这些类型中的任意一种
// 此处 () 的目的是为了提升优先级,表示:number 类型的数组或 string 类型的数组
let arr: (number | string)[] = [1, 'a', 3, 'b']
类型别名(type)
特点:
- 用type关键字来创建自定义类型
- 类型别名可以是任意合法的变量名称,推荐使用大写字母开头
- 创建类型别名后,直接使用该类型别名作为变量的类型注解即可 使用场景: 当同一类型(复杂)被多次使用时,可以通过类型别名,简化该类型的使用
type CustomArray = (number | string)[]
let arr1: CustomArray = [1,'a',3,'b']
let arr2: CustomArray = [4,'x',5,'y']
函数类型-参数和返回值
-
函数的类型实际上指的是: 函数参数 和 返回值的类型
-
函数指定类型的两种方式:
- 单独指定参数,返回值的类型
// 函数声明
function add(num1: number, num2: number): number {
return num1 + num2
}
// 箭头函数
const add = (num1: number, num2: number): number => {
return num1 + num2
}
- 同时指定参数、返回值的类型
当函数作为表达式时,可以通过类似箭头函数形式的语法来为函数添加类型
注意:这种形式只适用于函数表达式
// 创建函数自定义类型
type AddFn = (num1: number, num2: number) => number
// 使用自定义类型作为函数add的类型
const add: AddFn = (num1, num2) => {
return num1 + num2
}
函数类型-void 类型
如果函数没有返回值,那么,函数返回值类型为void
function greet(name: string): void {
console.log('Hello', name)
}
注意:如果一个函数没有返回值,此时,在 TS 的类型中,应该使用 void 类型
注意:不要与 undefined 类型混淆
// 如果什么都不写,此时,add 函数的返回值类型为: void
const add = () => {}
// 这种写法是明确指定函数返回值类型为 void,与上面不指定返回值类型相同
const add = (): void => {}
// 但如果指定 返回值类型为 undefined,此时,函数体中必须显示 return undefined 才可以
const add = (): undefined => {
// 此处,返回的 undefined 是 JS 中的一个值
return undefined
}
函数类型-可选参数
使用场景: 使用函数实现某个功能时,参数可传可不传。这种情况下,在给函数参数指定类型时,就用到可选参数了
比如,数组的slice方法,可以slice()也可以slice(1)还可以slice(1, 3)
function mySlice(start?: number, end?: number): void {
console.log('起始索引', start, '结束索引',end)
}
可选参数: 在参数名称后面添加'?'
注意:可选参数只能出现在参数列表的最后,也就是说可选参数后面不能再出现必选参数
注意:参数默认值和可选参数是互斥的,一般只需要指定一种即可
如果参数有默认值,那么该参数默认就是可选的
对象类型
JS中的对象是由属性和方法构成的,而TS对象的类型就是在描述对象的结构(有什么类型的属性和方法)
对象类型的写法
1、创建类型别名
// 创建类型别名
type Person = {
name: string,
greet: (name: string) => void,
sayHi: () => void,
url: string,
method?: string // 可选的对象类型
}
2、使用接口为对象指定类型
当一个对象类型被多次使用时,也可以使用接口(interface)来描述对象的类型,达到复用的目的
interface IProps {
name: string;
age?: number;
sayHi(): void;
greet: (name: string) => void;
}
let person: IProps = {
name: 'guo',
age: 2,
sayHi() {},
greet: (f) => {}
}
- 使用
interface关键字来声明接口 - 接口名称(比如:此处的IProps),可以是任意合法的变量名称,推荐以‘I’开头
- 声明接口后,直接使用接口名称作为变量的类型
- 因为每一行只有一个属性类型,因此,属性类型后面可以没有;(分号)
3、对象类型 type vs interface
interface接口 和 type类型别名的对比:
相同点: 都可以给对象指定类型
不同点:
接口: 只能为对象指定类型
类型别名: 不仅可以为对象指定类型,实际上可以为任意类型指定别名
注意: interface 和 type在使用上还有其他的不同之处
// 为对象类型创建接口
interface IPerson {
name: string;
age?: number;
sayHi(): void;
}
// 为对象类型创建类型别名
type IPerson = {
name: string,
age: number,
sayHi(): void,
}
// 为联合类型创建类型别名
type NumStr = number | string
4、对象类型-接口继承(extends)
如果两个接口之间有相同的属性或方法,可以将公共的属性或方法抽离出来,通过继承来实现复用****
比如,这两个接口都有 x、y 两个属性,重复写两次,可以,但很繁琐
interface IPoint 2D {
x: number;
y: number
}
interface IPoint 3D extends IPoint {
z: number;
}
// 继承后Point3D的结构 { x: number, y: number, z: number }
- 使用
extends关键字实现了接口point3D继承Point2D - 继承后, Point3D就有了Point2D中的所有属性和方法(此时,Point3D同时拥有x,y,z三个属性)
对象类型的总结:
1、对象类型实际上就是在描述对象的结构
2、推荐使用 接口 或者 type(类型别名)来指定对象的类型
交叉类型(&)
语法:&,交叉类型(intersection types)
- 作用:组合现有的对象类型,可以模拟接口继承的功能
- 比如,Point3D 组合了 Point2D 和 后面的对象,所以,Point3D 就同时具有了 Point2D 和 后面对象中的所有属性
// 使用type类型别名来模拟 Point2D 和 Point3D
type Point2D = {
x: number,
y: number
}
// 使用交叉类型来实现接口继承的功能 Point3D就同时拥有了 Point2D和后面对象的 所有的属性了
type Point3D = Point2D & {
z: number
}
let 0: Point3D = {
x: 1,
y: 2,
z: 3
}
元祖类型(Tuple)
- 元组类型是另一种类型的数组,它确切地知道包含多少个元素,以及特定索引对应的类型****
- 元组类型可以确切地标记出有多少个元素,以及每个元素的类型
****场景:在地图中,使用经纬度来记录坐标信息
使用 number[] 的缺点:不严谨,因为该类型的数组中可以出现任意多个数字,也就是数组的长度是不确定的
let position: number[] = [116.2317, 39.5427]
// 该示例中,元素有两个元素,每个元素的类型都是 number
let position: [number, number] = [116.2317, 39.5427]
// 实际上,React 中 `useState` hook 的返回值类型就是一个元组类型
// 因为对于 useState 来说,它的返回值长度固定且每个索引对应的元素类型也是知道的
const [loading, setLoading] = useState(false)
TS类型推论
- 在 TS 中,某些没有明确指出类型的地方,TS 的类型推论机制会帮助提供类型
- 换句话说:由于类型推论的存在,这些地方,类型注解可以省略不写
- 发生类型推论的2种常见场景:
1. 声明变量并初始化时
2. 决定函数返回值时
// 变量 age 的类型被自动推断为:number
let age = 18
// 函数返回值的类型被自动推断为:number
// 注意:函数参数一定要添加类型
function add(num1: number, num2: number) {
return num1 + num2
}
- 推荐:能省略类型注解的地方就省略(充分利用TS类型推论的能力,提升开发效率)
- 技巧:如果不知道类型,可以通过鼠标放在变量名称上,利用 VSCode 的提示来查看类型
字面量类型
- 问题: 思考以下代码,两个变量的类型分别是什么?
let str1 = 'Hello TS'
const str2 = 'Hello TS'
// 通过TS的类型推论机制,可以得到答案
// 变量str1 的类型为: string
// 变量str2 的类型为: ‘Hello TS’
解释:
1、str1 是一个变量(let),它的值可以是任意字符串,所以类型为:string;
2、str2是一个常量(const), 它的值不能变化只能是'Hello TS',所以它的类型为'Hello TS'
注意:此处的'Hello TS' 就是一个字面量类型,也就是说某个特定的字符串也可以作为 TS 中的类型
实际上,任意的JS字面量(比如对象 数字等)都可以作为类型使用。
// 字面量类型 { name: 'gl' }
const obj: { name: 'gl' } = { name: 'gl' }
// 字面量类型 []
const arr: [] = []
// 字面量类型 18
const age: 18 = 18
// 字面量类型 false
const falseValue: false = false
// 字面量名词的解释:
// [1, 3, 5] 就是一个字面量值
const arr = [1, 3, 5]
const arr1 = new Array()
// { name: 'jack' } 也是一个字面量值
const obj = { name: 'jack' }
const obj = new Object()
1、字面量类型使用场景
使用场景: 字面量类型通常配合联合类型一起使用,用来表示一组明确的可选值列表
比如:方向的可选值只能是 上、下、左、右中的任意一个
// 使用type类型别名创建自定义类型
type Direction = 'left' | 'right' | 'up' | 'down'
function changeDirection(direction: Direction) {
console.log(direction)
}
// 调用函数时,会有类型提示
changeDirection('up')
- 参数direction的值 只能是 up/down/left/right中的任意一个
- 优势: 相比于string类型,使用字面量类型更加精确、严谨
枚举类型(enum)
枚举的功能类似于 字面量类型 + 联合类型组合 的功能,也可以表示一组明确的可选值
枚举: 定义一组命名常量。它描述一个值,该值可以是这些命名常量中的一个
// 创建枚举类型
enum Direction { Up, DOwn, Left, Right }
// 使用枚举类型 Direction.Up
function changeDirection(direction: Direction) {
console.log(direction)
}
// 调用函数时,需要传入枚举成员中的任意一个
// 类似于JS中的对象,直接通过点(.)语法 访问枚举的成员
changeDirection(Direction.Up)
解释:
-
使用
enum关键字定义枚举 -
约定枚举名称以大写字母开头
-
枚举中的多个值之间通过
,(逗号)分隔 -
定义好枚举后,直接使用枚举名称作为类型注解
1、枚举类型-数字枚举
问题: 把枚举成员作为函数的实参,通过将鼠标移入Direction.Up,可以看到枚举成员Up的值为0
注意: 枚举成员是有值的,默认为: 从0开始自增的数值
我们把枚举成员的值为数字的枚举, 称为数字枚举
当然,也可以给枚举中的成员初始化值
// Down -> 11 Left -> 12 Right -> 13
enum Direction { Up = 10, Down, Left, Right }
enum Direction { Up = 2, Down = 4, Left = 8, Right = 16 }
2、枚举类型-字符串枚举
枚举成员的值为字符串的枚举称为字符串枚举
注意: 字符串没有自增长行为,因此, 字符串枚举的每个成员都必须要有初始值
enum Direction {
Up = 'UP',
Down = 'DOWN',
Left = 'LEFT',
Right = 'RIGHT',
}
3、枚举类型-枚举实现原理
枚举是TS为数不多的非 JavaScript类型级扩展(不仅仅是类型)的特性之一
因为: 其他类型仅仅被当做类型,而枚举不仅用作类型,还提供值(枚举成员都是有值的)
也就是说,其他类型会在编译为JS代码时自动移除。但是, 枚举类型会被编译为JS代码
enum Direction {
Up = 'UP',
Down = 'DOWN',
Left = 'LEFT',
Right = 'RIGHT'
}
// 会被编译为以下 JS 代码:
// 整体来看:将枚举转化成了 JS 中的一个对象
/*
var Direction = {
Up: 'UP',
Down: 'DOWN',
Left: 'LEFT',
Right: 'RIGHT'
}
*/
var Direction;
(function (Direction) {
Direction["Up"] = "UP";
Direction["Down"] = "DOWN";
Direction["Left"] = "LEFT";
Direction["Right"] = "RIGHT";
})(Direction || (Direction = {}));
说明: 枚举与前面的 字面量类型 + 联合类型 组合的功能类似, 都用来表示一组明确的可选值列表
一般情况下,推荐使用 字面量类型+联合类型组合的方式,因为相比较枚举,这种方式更加直观、简洁、高效
any类型
原则上:不推荐使用any 这会让TypeScript变成AnyScript(失去TS类型保护的优势)
因为当值的类型为any时,可以对该值进行任意操作,并且不会有代码提示
let obj: any = { x: 0 }
obj.bar = 100
obj()
const n: number = obj
尽可能避免使用any类型,除非临时使用any来避免书写很长、很复杂的类型
其他隐式具有any类型的情况:
- 声明变量不提供类型也不提供初始值
- 函数参数不加类型
注意: 因为不推荐使用any, 所以,这两种情况下都应该提供类型
TS类型断言(as)
有时我们会比 TS 更加明确一个值的类型,此时,可以使用类型断言来指定更具体的类型。 比如,
// 假设页面中有个 id 为 link 的 a 标签:
// <a id="link" href="http://baidu.com.cn/">百度</a>
// 我们希望通过 DOM 拿到 a 标签的 href 属性
const aLink = document.getElementById('link')
- 该方法返回值的类型是 HTMLElement,该类型只包含所有标签公共的属性或方法,不包含 a 标签特有的 href 等属性
- 因此,这个类型太宽泛(不具体),无法操作 href 等 a 标签特有的属性或方法
- 解决方式:这种情况下就需要使用类型断言指定更加具体的类型****
使用类型断言:
1. 使用 as 关键字实现类型断言
2. 关键字 as 后面的类型是一个更加具体的类型(HTMLAnchorElement 是 HTMLElement 的子类型)
3. 通过类型断言,aLink 的类型变得更加具体,这样就可以访问 a 标签特有的属性或方法了
// 使用类型断言来指定为更加具体的 HTMLAnchorElement 类型
const aLink = document.getElementById('link') as HTMLAnchorElement
// 另一种语法,使用 `<>` 语法,不推荐:
const aLink = <HTMLAnchorElement>document.getElementById('link')
技巧:在浏览器控制台,通过 $0.__proto__ 可以获取当前DOM 元素的类型
typeof运算符(类型查询)
JS中提供了typeof操作符,用来在JS中获取数据类型
console.log(typeof 'hello') // string
实际上,TS也提供了 typeof操作符: 可以在 类型上下文 中引用 变量 或 属性 的类型(类型查询)
使用场景: 根据已有的变量,获取该值的类型,简化类型书写
let p = { x: 1, y: 2 }
// 对象字面量形式
function formatPoint(point: { x: number, y: number }) {}
formatPoint(p)
// 使用typeof p 获取变量p 在TS中的类型
function formatPoint(point: typeof p) {}
-
使用
typeof操作符来获取变量 p 的类型,结果与第一种(对象字面量形式的类型)相同 -
typeof 出现在类型注解的位置(参数名称的冒号后面)所处的环境就在类型上下文(区别于 JS 代码)
-
注意:typeof 只能用来
查询变量或属性的类型,无法查询其他形式的类型(比如,函数调用的类型)
TypeScript高级类型
TS中的类型兼容性
两种类型系统:1、Structural Type System(结构化类型系统) 2、Nominal Type System(标明类型系统)
TS采用的是结构化类型系统,也叫做duck typing(鸭子类型), 类型检查关注的是值所具有的形状;也就是在结构类型系统中,如果两个对象具有相同的形状,则认为它们属于同一类型。比如:
interface Point { x: number; y: number }
interface Point2D { x: number; y: number }
let p2: Point2D = {
x: 2,
y: 1
}
// 不会报错
let p: Point = p2
对于对象类型来说,成员少的兼容成员多的 (成员多的可以赋值给少的,或者说:只要满足必须的类型就行,多了也没关系)
interface Point2D { x: number; y: number }
interface Point3D { x: number; y: number; z: number }
let p3: Point3D = {
x: 1,
y: 2,
z:3
}
// 不会报错 成员多的可以赋值给成员少的
let p2: Point2D = p3
函数类型的类型兼容性比较复杂,需要考虑:1、参数个数 2、返回值类型等等
1、参数个数: 参数多的兼容参数少的(或者说 参数少的可以赋值给多的)
- 参数个数: 在js中省略用不到的函数参数是非常常见的,这样的使用方式,促成了 TS 中函数类型之间的兼容性
const arr = ['a', 'b', 'c']
// arr.forEach 第一个参数的类型为: (value: string, index: number, array: string[]) => void
arr.forEach(() => {})
arr.forEach((item) => {})
arr.forEach((item, index) => {})
// ---
type F1 = (a: number) => void
type F2 = (a: number, b: number) => void
// 正确: 参数少的可以赋值给参数多的
let f1: F1 = a => {}
let f2: F2 = f1
- 返回值类型:只要满足必须的类型要求就行,多了也没事
type F1 = () => void
let fn: F1 = () => {
return 123
}
泛型
概述: 泛型(Generics)可以在保证类型安全前提下,让函数等与多种类型一起工作,从而实现复用,常用于:函数、接口、class 中
创建泛型函数:
function id<T> (value: T): T {
return value
}
解释:
-
语法:在函数名称的后面添加 <>(尖括号),尖括号中添加类型变量,比如此处的 T
-
类型变量 T,是一种特殊类型的变量,它处理类型而不是值
-
类型变量相当于一个类型容器,能够捕获用户提供的类型(具体是什么类型由用户调用该函数时指定)
-
因为 T 是类型,因此可以将其作为函数参数和返回值的类型,表示参数和返回值具有相同的类型
调用泛型函数:
// 函数参数和返回值的类型都是number
const num = id<number>(10)
const str = id<string>('a')
解释:
- 语法:在函数名称的后面添加 <>(尖括号),尖括号中指定具体的类型,比如,此处的 number
- 当传入类型 number 后,这个类型就会被函数声明时指定的类型变量 T 捕获到
- 此时,T 的类型就是 number,所以,函数 id 参数和返回值的类型也都是 number
- 这样,通过泛型就做到了让 id 函数与多种不同的类型一起工作,实现了复用的同时保证了类型安全
注意:
在调用泛型函数时,可以省略 <类型> 来简化泛型函数的调用
泛型约束
使用extends关键字来为泛型函数添加类型约束
// 1. 指定更加具体的类型
function fn<T>(params: T[]): T[] {
console.log(params.length)
return params
}
// 2. 添加泛型约束
// 能够使用extends关键字来为泛型函数添加类型约束
interface ILength {
length: number
}
// 解释:表示传入的类型必须满足 ILength 接口的要求才行,也就是得有一个 number 类型的 length 属性
function fn<T extends ILength>(params: T): T {
console.log(params.length)
return params
}
解释:
- 创建泛型约束的接口 ILength,该接口要求提供 length 属性
- 通过 extends 关键字来为泛型(类型变量T)添加约束
- 该约束表示:传入的类型必须具有 length 属性 也就是说传入的实参(数组 字符串)只要有 length 属性即可(类型兼容性)
多个类型变量的泛型
泛型的类型变量可以有多个,并且类型变量之间还可以约束**(比如,第二个类型变量受第一个类型变量约束)**
比如,创建一个函数来获取对象中属性的值:
function getProp<Type, Key extends keyof Type>(obj: Type, key: Key) {
return obj[key]
}
let person = { name: 'jack', age: 18 }
getProp(person, 'name')
// Type extends object 表示: Type 应该是一个对象类型,如果不是 对象 类型,就会报错
function getProperty<Type extends object, Key extends keyof Type>(obj: Type, key: Key) {
return obj[key]
}
解释:
- 添加了第二个类型变量 Key,两个类型变量之间使用 , 逗号分隔。
- keyof 关键字接收一个对象类型,生成其键名称(字符串)的联合类型。
- 本示例中 keyof Type 实际上获取的是 person 对象所有键的联合类型,也就是:'name' | 'age'
- 类型变量 Key 受 Type 约束,可以理解为:Key 只能是 Type 所有键中的任意一个,或者说只能访问对象中存在的属性
泛型接口 在接口名称后面添加<>这个接口就变成了泛型接口
泛型接口:接口也可以配合泛型来使用,以增加其灵活性,增强其复用性
interface IdFunc<T> {
id: (value: T) => T;
ids: () => T[];
}
// 定义
let obj: IdFunc<number> = {
id(value) {
return value
},
ids() {
return [1,2,3]
}
}
解释:
1. 在接口名称的后面添加 <类型变量>,那么,这个接口就变成了泛型接口。
2. 接口的类型变量,对接口中所有其他成员可见,也就是接口中所有成员都可以使用类型变量**。**
3. 使用泛型接口时,需要显式指定具体的类型(比如,此处的 IdFunc)。
4. 此时,id 方法的参数和返回值类型都是 number;ids 方法的返回值类型是 number[]。
泛型工具类型
泛型工具类型:TS 内置了一些常用的工具类型,来简化 TS 中的一些常见操作
说明:它们都是基于泛型实现的(泛型适用于多种类型,更加通用),并且是内置的,可以直接在代码中使用。 这些工具类型有很多,常见类型:
1. Partial<Type>
2. Readonly<Type>
3. Pick<Type, Keys>
1、Partial
作用: Partial 用来构造(创建)一个类型,将 Type 的所有属性设置为可选。
type Props = {
name: string,
children: string[]
}
interface IProps {
name: string;
id: number;
children: string[];
}
type PartialProps = Partial<IProps> // PartialProps中所有的属性都是可选的
解释:构造出来的新类型 PartialProps 结构和 IProps 相同,但所有属性都变为可选的。
2、Readonly
作用: 用来构造一个类型,将 Type 的所有属性都设置为 readonly(只读)。
type Props = {
id: string
children: number[]
}
type ReadonlyProps = Readonly<Props>
let props: ReadonlyProps = { id: '1', children: [] }
// 错误演示
props.id = '2' // 当给 id 属性赋值时,就会报错:无法分配到 "id" ,因为它是只读属性。
解释:构造出来的新类型 ReadonlyProps 结构和 Props 相同,但所有属性都变为只读的
3、Pick<Type, keys>
作用:Pick<Type, Keys> 从 Type 中选择一组属性来构造新类型。
type Props = {
id: number,
name: string,
children: string[],
}
type PickProps = Pick<Props, 'id' | 'name'>
解释:
1. Pick 工具类型有两个类型变量:1 表示选择谁的属性 2 表示选择哪几个属性。
2. 其中第二个类型变量,如果只选择一个则只传入该属性名即可,如果有多个使用联合类型即可。
3. 第二个类型变量传入的属性只能是第一个类型变量中存在的属性。
4. 构造出来的新类型 PickProps,只有 id 和 name 两个属性类型。
创建基于ts的react项目
npx create-react-app react-ts --template typescript
说明:在命令行中,添加 --template typescript 表示创建支持 TS 的项目
tsconfig
- tsconfig.json是TS项目的配置文件,用来指定如何编译TS代码
- 手动创建tsconfig.json配置文件的命令: tsc --init
- tsconfig文档
// tsconfig.json
{
// 编译选项
"compilerOptions": {
// 生成代码的语言版本: 将ts代码编译成哪个版本的JS代码
"target": "es5",
// 指定要包含在编译中的library
"lib": [
"dom",
"dom.iterable",
"esnext"
],
// 允许ts编译器编译js文件
"allowJs": true,
// 跳过类型声明文件的类型检查
"skipLibCheck": true,
// 屏蔽ESmodule 和 commonJS之间的差异
"esModuleInterop": true,
// 允许通过 import * from 'x' 即使模块没有显式指定default导出
"allowSyntheticDefaultImports": true,
"strict": true,
// 对文件名称强制区分大小写
"forceConsistentCasingInFileNames": true,
// 严格校验switch case语法
"noFallthroughCasesInSwitch": true,
// 生成代码的模块化标准
"module": "esnext",
// 指定模块的解析策略
"moduleResolution": "node",
// 允许导入扩展名为.json的模块
"resolveJsonModule": true,
// 是否将没有import/export的文件视为全局而非模块化的脚本文件 无条件的触发导入未解决的文件
"isolatedModules": true,
// 编译时不生成任何JS文件(只进行类型检查)
"noEmit": true,
// 指定将jsx编译成什么形式
"jsx": "react-jsx"
},
// 指定允许ts处理的目录
"include": [
"src"
]
}
TS的两种文件类型
- .ts文件
-
既包含类型信息又包含可执行代码
-
可以被编译为.js文件
-
用途:编写程序代码的地方
- .d.ts文件
-
只包含类型信息的类型声明文件
-
不会生成.js文件,仅用于提供类型信息,在.d.ts文件中是不允许出现可执行代码, 只用于提供类型
-
用途:为js提供类型信息
总结:
- .ts 是 implementation(代码实现文件)
- .d.ts 是 declaration(类型声明文件)
- 如果要为 JS 提供类型信息,要使用 .d.ts 文件
类型声明文件
类型声明文件-内置
TS 为 JS 运行时可用的所有标准化内置 API 都提供了类型声明文件
如: forEach
类型声明文件-第三方库
目前几乎所有常用的第三方库都有相应的类型声明文件
第三方库的类型声明文件有两种存在形式:1 库自带类型声明文件 2 由 DefinitelyTyped 提供
-
库自带类型声明文件:如axios
- 正常导入该库,TS 就会自动加载库自己的类型声明文件,以提供该库的类型声明
-
由 DefinitelyTyped 提供
- DefinitelyTyped 是一个 github 仓库,用来提供高质量 TypeScript 类型声明,DefinitelyTyped 链接
- 可以通过 npm/yarn 来下载该仓库提供的 TS 类型声明包,这些包的名称格式为:@types/*,比如,@types/react、@types/lodash 等
- 项目开发中,如果我们使用的第三方库没有自带的声明文件,VSCode 会给出明确的提示
类型声明文件-自定义
在项目开发中,有两种常见情况,需要自己手动创建类型声明文件:1 项目内共享类型 2 为已有 JS 文件提供类型声明
-
项目内共享类型
-
如果多个 .ts 文件中都用到同一个类型,此时可以创建 .d.ts 文件提供该类型,实现类型共享
-
操作步骤:
- 创建 index.d.ts 类型声明文件
- 创建需要共享的类型,并使用 export 导出(TS 中的类型也可以使用 import/export 实现模块化功能)
- 在需要使用共享类型的 .ts 文件中,通过 import 导入即可(.d.ts 后缀导入时,直接省略)
注意: ts会自动识别文件中的.d.ts,然后整合到一起,位置随便放,无需import export
-
-
为已有 JS 文件提供类型声明
- 在将 JS 项目迁移到 TS 项目时,为了让已有的 .js 文件有类型声明
类型声明文件的使用
declare 关键字:用于类型声明,为其他地方(如.js 文件)已存在的变量声明类型,而不是创建一个新的变量
- 对于 type、interface 等这些明确就是 TS 类型的(只能在 TS 中使用的),可以省略 declare 关键字
- 对于 let、const、function 等具有双重含义(在 JS、TS 中都能用),应该使用 declare 关键字,明确指定此处用于类型声明
类型声明文件的总结
类型声明文件出现目的:为 JS 文件提供类型声明、实现类型共享
类型声明文件的后缀:.d.ts
类型声明文件中只应该出现类型,不要有任何的实现(区别于 .ts 文件)
使用类型声明文件:只需要关注一种情况,没有自带类型声明文件的第三方库,VSCode 在发现没有类型声明文件时,会给出提示,只需按照提示来安装类型声明文件即可: yarn add @types/* 来安装即可。
在React项目中使用TypeScript
-
useEffect
useEffect Hook不涉及任何类型, TS 和 JS中的使用完全一致
-
useState
useState Hook是一个泛型函数,接收一个类型变量来指定状态的类型
// 该类型变量,不仅指定了状态的类型,也指定了setName修改状态函数的参数类型
const [name, setName] = useState<string>('glfan')
setName(13) // 报错
注意:
1)在使用useState时,只要提供了初始值, TS会自动根据初始值来推断出状态类型,因此,类型变量可以省略
2)如果 TS 自动推断出来的类型不准确,还得显式指定泛型类型
3)如果useState的初始值是对象、数组等复杂数据类型,需要明确指定泛型类型
interface Todo {
name: string;
id: number;
completed: boolean;
}
const [list, setList] = useState<Todo[]>([])
- never 类型表示: 永远不会出现的值的类型
useRef
useRef Hook接收一个类型变量,用于指定current属性的值的类型
如: 使用ref操作dom
// 正确的用法
const elRef = useRef<HTMLInputElement>(null)
const getIptValue = () => {
console.log(elRef.current?.value);
}
说明:?. 可选链操作符
作用:可选链操作符( ?. )允许读取位于对象链深处的属性的值,而不必明确验证链中的每个引用是否有效。
const elRef = useRef<HTMLInputElement>(null)
// ! TS非空断言
// 如果明确知道对象的属性一定不会为空, 那么就可以使用非空断言!
const getIptValue = () => {
console.log(elRef.current!.value);
}
事件对象类型
技巧:在行内事件中,鼠标移动到e上面可以看到具体的事件对象类型
- 函数组件
interface IProps {
name: string,
applyId: string;
}
// 第一种写法
const InterviewItem: FC<IProps> = ({ name, applyId }) => {}
// 第二种写法
const InterviewItem = ({name, applyId }: IProps) => {}