ts+react

417 阅读25分钟

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']

函数类型-参数和返回值

  • 函数的类型实际上指的是: 函数参数 和 返回值的类型

  • 函数指定类型的两种方式:

  1. 单独指定参数,返回值的类型
    // 函数声明
    function add(num1: number, num2: number): number {
      return num1 + num2
    }
    // 箭头函数
    const add = (num1: number, num2: number): number => {
      return num1 + num2
    }

  1. 同时指定参数、返回值的类型

当函数作为表达式时,可以通过类似箭头函数形式的语法来为函数添加类型

注意:这种形式只适用于函数表达式

// 创建函数自定义类型
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 更加明确一个值的类型,此时,可以使用类型断言来指定更具体的类型。 比如,

  // 假设页面中有个 idlink 的 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]
}

解释:

  1. 添加了第二个类型变量 Key,两个类型变量之间使用 , 逗号分隔。
  2. keyof 关键字接收一个对象类型,生成其键名称(字符串)的联合类型。
  3. 本示例中 keyof Type 实际上获取的是 person 对象所有键的联合类型,也就是:'name' | 'age'
  4. 类型变量 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>

- TS 所有内置的泛型工具类型文档

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文件
  1. 既包含类型信息又包含可执行代码

  2. 可以被编译为.js文件

  3. 用途:编写程序代码的地方

  • .d.ts文件
  1. 只包含类型信息的类型声明文件

  2. 不会生成.js文件,仅用于提供类型信息,在.d.ts文件中是不允许出现可执行代码, 只用于提供类型

  3. 用途:为js提供类型信息

    总结

    • .ts 是 implementation(代码实现文件)
    • .d.ts 是 declaration(类型声明文件)
    • 如果要为 JS 提供类型信息,要使用 .d.ts 文件

类型声明文件

类型声明文件-内置

TS 为 JS 运行时可用的所有标准化内置 API 都提供了类型声明文件

如: forEach

类型声明文件-第三方库

目前几乎所有常用的第三方库都有相应的类型声明文件

第三方库的类型声明文件有两种存在形式:1 库自带类型声明文件 2 由 DefinitelyTyped 提供

  1. 库自带类型声明文件:如axios

    • 正常导入该库,TS 就会自动加载库自己的类型声明文件,以提供该库的类型声明
  2. 由 DefinitelyTyped 提供

    • DefinitelyTyped 是一个 github 仓库,用来提供高质量 TypeScript 类型声明,DefinitelyTyped 链接
    • 可以通过 npm/yarn 来下载该仓库提供的 TS 类型声明包,这些包的名称格式为:@types/*,比如,@types/react、@types/lodash 等
    • 项目开发中,如果我们使用的第三方库没有自带的声明文件,VSCode 会给出明确的提示

类型声明文件-自定义

在项目开发中,有两种常见情况,需要自己手动创建类型声明文件:1 项目内共享类型 2 为已有 JS 文件提供类型声明

  1. 项目内共享类型

    • 如果多个 .ts 文件中都用到同一个类型,此时可以创建 .d.ts 文件提供该类型,实现类型共享

    • 操作步骤:

      1. 创建 index.d.ts 类型声明文件
      2. 创建需要共享的类型,并使用 export 导出(TS 中的类型也可以使用 import/export 实现模块化功能)
      3. 在需要使用共享类型的 .ts 文件中,通过 import 导入即可(.d.ts 后缀导入时,直接省略) 注意: ts会自动识别文件中的.d.ts,然后整合到一起,位置随便放,无需import export
  2. 为已有 JS 文件提供类型声明

    1. 在将 JS 项目迁移到 TS 项目时,为了让已有的 .js 文件有类型声明

类型声明文件的使用

declare 关键字:用于类型声明,为其他地方(如.js 文件)已存在的变量声明类型,而不是创建一个新的变量

  1. 对于 type、interface 等这些明确就是 TS 类型的(只能在 TS 中使用的),可以省略 declare 关键字
  2. 对于 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 类型表示: 永远不会出现的值的类型

one.png

useRef

useRef Hook接收一个类型变量,用于指定current属性的值的类型

如: 使用ref操作dom

two.png

// 正确的用法
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上面可以看到具体的事件对象类型

three.png

  • 函数组件
interface IProps {
  name: string, 
  applyId: string;
}
// 第一种写法
const InterviewItem: FC<IProps> = ({ name, applyId  }) => {}

// 第二种写法
const InterviewItem = ({name, applyId }: IProps) => {}