TypeScript基本概念

TypeScript 是什么？

目标：能够说出什么是typescript

内容：

TypeScript 简称：TS，可以理解为是增强版的JavaScript，是 JavaScript 的超集，简单来说就是：JS 有的 TS 都有

TypeScript = Type + JavaScript（在 JS 基础之上，为 JS 添加了类型支持）
TypeScript 是微软开发的开源编程语言，编译后就是 js，可以在任何运行 JavaScript 的地方运行

为什么要有typescript

目标：能够说出为什么需要有typescript

内容：

背景：JS 的类型系统存在“先天缺陷”弱类型，JS 代码中绝大部分错误都是类型错误（Uncaught TypeError）
- 开发的时候，定义的变量本应该就有类型
这些经常出现的错误，导致了在使用 JS 进行项目开发时，增加了找 Bug、改 Bug 的时间，严重影响开发效率

为什么会这样？ var num = 18 num.toLowerCase()

从编程语言的动静来区分，TypeScript 属于静态类型的编程语言，JavaScript 属于动态类型的编程语言
- 静态类型：编译期做类型检查
- 动态类型：执行期做类型检查
代码编译和代码执行的顺序：1 编译 2 执行
对于 JS 来说：需要等到代码真正去执行的时候才能发现错误（晚）
对于 TS 来说：在代码编译的时候（代码执行前）就可以发现错误（早）

并且，配合 VSCode 等开发工具，TS 可以提前到在编写代码的同时就发现代码中的错误，减少找 Bug、改 Bug 时间

对比：

使用 JS：
1. 在 VSCode 里面写代码
2. 在浏览器中运行代码 --> 运行时，才会发现错误【晚】
使用 TS：
1. 在 VSCode 里面写代码 --> 写代码的同时，就会发现错误【早】
2. 在浏览器中运行代码

Vue 3 源码使用 TS 重写、Angular 默认支持 TS、React 与 TS 完美配合，TypeScript 已成为大中型前端项目的首选编程语言

目前，前端最新的开发技术栈：

React： TS + Hooks
Vue： TS + Vue3

注意： Vue2 对 TS 的支持不好~

安装编译 TS 的工具包

目标： 能够安装ts的工具包来编译ts

内容：

问题：为什么要安装编译 TS 的工具包?
回答：Node.js/浏览器，只认识 JS 代码，不认识 TS 代码。需要先将 TS 代码转化为 JS 代码，然后才能运行
- 安装命令：npm i -g typescript 或者 yarn global add typescript
- typescript 包：用来编译 TS 代码的包，提供了 tsc 命令，实现了 TS -> JS 的转化
- 注意：Mac 电脑安装全局包时，需要添加 sudo 获取权限：sudo npm i -g typescript yarn 全局安装：sudo yarn global add typescript
验证是否安装成功：tsc –v(查看 typescript 的版本)

编译并运行 TS 代码

目标： 能够理解typescript的运行步骤

内容：

创建 hello.ts 文件（注意：TS 文件的后缀名为 .ts）
将 TS 编译为 JS：在终端中输入命令，tsc hello.ts（此时，在同级目录中会出现一个同名的 JS 文件）
执行 JS 代码：在终端中输入命令，node hello.js

1 创建 ts 文件 ===> 2 编译 TS ===> 3 执行 JS

说明：所有合法的 JS 代码都是 TS 代码，有 JS 基础只需要学习 TS 的类型即可
注意：由 TS 编译生成的 JS 文件，代码中就没有类型信息了

真正在开发过程中，其实不需要自己手动的通过tsc把ts文件转成js文件，这些工作应该交给webpack或者vite来完成

创建基于TS的vue项目

目标：能够使用vite创建vue-ts模板的项目

内容：

基于vite创建一个vue项目，使用typescript模板

yarn create vite
或
yarn create vite vite-ts-demo  --template vue-ts

步骤：

创建项目
删除 src文件，自己新建 main.ts
解决 isolatedModules 报错
正常书写代码

TypeScript基础

类型注解

目标： 能够理解什么是typescript的类型注解

内容：

TypeScript 是 JS 的超集，TS 提供了 JS 的所有功能，并且额外的增加了：类型系统
- 所有的 JS 代码都是 TS 代码
- JS 有类型（比如，number/string 等），但是 JS 不会检查变量的类型是否发生变化，而 TS 会检查

示例代码:

let age = 18

let age: number = 18

说明：代码中的 : number 就是类型注解
作用：为变量添加类型约束。比如，上述代码中，约定变量 age 的类型为 number 类型
解释：约定了什么类型，就只能给变量赋值该类型的值，否则，就会报错
约定了类型之后，代码的提示就会非常的清晰
错误演示：

// 错误代码：
// 错误原因：将 string 类型的值赋值给了 number 类型的变量，类型不一致
let age: number = '18'

TypeScript类型概述

目标： 能够理解TypeScript中有哪些数据类型

内容：

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

JS 已有类型
- 原始类型，简单类型（number/string/boolean/null/undefined）
- 复杂数据类型（数组，对象，函数等）
TS 新增类型
- 联合类型 |
- 自定义类型（类型别名） type
- 接口 interface
- 元组
- 字面量类型
- 枚举 enum
- void
- ...

TypeScript原始数据类型

原始类型：number/string/boolean/null/undefined
特点：简单，这些类型，完全按照 JS 中类型的名称来书写

let age: number = 18
let myName: string = '老师'
let isLoading: boolean = false

// 等等...

数组类型

目标： 掌握ts中数组类型的两种写法

内容：

数组类型的两种写法：
- 推荐使用 number[] 写法

export default {};

/* 
    数组的类型注解
    1. 写法1： 类型[]
    2. 写法2： Array<类型>
*/
let arr: number[] = [15000, 12000, 10000];
// arr.push("200"); // 报错
// let arr2: number[] = [15000, 12000, 10000, undefined]; // 报错

let arr3: string[] = ["zs", "li"];
let arr4: boolean[] = [true, true, false];

// 写法2,泛型写法
let arr5: Array<number> = [15000, 12000, 10000];

联合类型

目标： 能够通过联合类型将多个类型组合成一个类型

内容：

需求：数组中既有 number 类型，又有 string 类型，这个数组的类型应该如何写?

let arr: (number | string)[] = [1, 'a', 3, 'b']

解释：|（竖线）在 TS 中叫做联合类型，即：由两个或多个其他类型组成的类型，表示可以是这些类型中的任意一种
注意：这是 TS 中联合类型的语法，只有一根竖线，不要与 JS 中的或（|| 或）混淆了

/* 
    联合类型注解：
    作用：
        把多种类型连个起来，形成一种类型给变量使用

    语法：
    | ， 跟JS的或 || 非常相似
*/

// let temp: number | string | boolean;
// temp = 10;
// temp = "10";
// temp = true;

// 注意 | 的优先级，使用小括号包起来
let arr: (string | number)[] = ["zs", 15000];

类型别名

目标： 能够使用类型别名给类型起别名

内容：

类型别名（自定义类型）：为任意类型起别名
使用场景：当同一类型（复杂）被多次使用时，可以通过类型别名，简化该类型的使用

type CustomArray = (number | string)[]

let arr1: CustomArray = [1, 'a', 3, 'b']
let arr2: CustomArray = ['x', 'y', 6, 7]

解释:
1. 使用 type 关键字来创建自定义类型
2. 类型别名（比如，此处的 CustomArray）可以是任意合法的变量名称
3. 推荐使用大写字母开头
4. 创建类型别名后，直接使用该类型别名作为变量的类型注解即可

函数类型

基本使用

目标： 能够给函数指定类型

内容：

函数的类型实际上指的是：函数参数和返回值的类型
为函数指定类型的两种方式：
1. 单独指定参数、返回值的类型
2. 同时指定参数、返回值的类型

// 函数声明
function add(num1: number, num2: number): number {
  return num1 + num2
}

// 箭头函数
const add = (num1: number, num2: number): number => {
  return num1 + num2
}

类型别名写法

/* 
    函数注解 - 类型别名type：
	注意：只能在函数表达式(箭头函数)中使用
    语法：
    type 类型名 = (参数1:类型, 参数2:类型) => 类型
*/
type AddFn = (num1: number, num2: number) => number

const add: AddFn = (num1, num2) => {
  return num1 + num2
}

// function add(){} 不可以使用

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

void 类型

目标： 能够了解void类型的使用

内容：

如果函数没有返回值，那么，函数返回值类型为：void

function greet(name: string): void {
  console.log('Hello', name)
}

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

// 如果什么都不写，此时，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)
}

可选参数：在可传可不传的参数名称后面添加 ?（问号）
注意：可选参数只能出现在参数列表的最后，也就是说可选参数后面不能再出现必选参数

默认参数

目标： 能够使用给函数参数添加默认值

内容：

给参数添加默认值，设置后，TS 会自动推导出参数的 TS 类型

function mySlice(start = 100, end = 200) {
  console.log('起始索引：', start, '结束索引：', end)
}

类型推论

在 TS 中，某些没有明确指出类型的地方，TS 的类型推论机制会帮助提供类型
换句话说：由于类型推论的存在，这些地方，类型注解可以省略不写
发生类型推论的 2 种常见场景:
1. 声明变量并初始化时，(形参也属于声明变量)
2. 决定函数返回值时

// 变量 age 的类型被自动推断为：number
let age = 18

// 函数返回值的类型被自动推断为：number
function add(num1: number, num2: number): number {
  return num1 + num2
}

推荐：能省略类型注解的地方就省略（偷懒，充分利用TS类型推论的能力，提升开发效率）
技巧：如果不知道类型，可以通过鼠标放在变量名称上，利用 VSCode 的提示来查看类型

对象类型

基本使用

目标： 掌握对象类型的基本使用

内容：

JS 中的对象是由属性和方法构成的，而 TS 对象的类型就是在描述对象的结构（有什么类型的属性和方法）
对象类型的写法:
1. 使用 {} 来描述对象结构
2. 属性采用属性名: 类型的形式
3. 方法采用方法名(): 返回值类型的形式

// 空对象
let person: {} = {}

// 有属性的对象
let person: { name: string } = {
  name: '同学'
}

// 既有属性又有方法的对象
// 在一行代码中指定对象的多个属性类型时，使用 `;`（分号）来分隔
let person: { name: string; sayHi(): void } = {
  name: 'jack',
  sayHi() {}
}

// 对象中如果有多个类型，可以换行写：
// 通过换行来分隔多个属性类型，可以去掉 `;`
let person: {
  name: string
  sayHi(): void
} = {
  name: 'jack',
  sayHi() {}
}

箭头函数形式的方法类型

方法的类型也可以使用箭头函数形式

{
    greet(name: string):string,
    greet: (name: string) => string
}



type Person = {
  greet: (name: string) => void
  greet(name: string):void
}

let person: Person = {
  greet(name) {
    console.log(name)
  }
}

对象可选属性

对象的属性或方法，也可以是可选的，此时就用到可选属性了
比如，我们在使用 axios({ ... }) 时，如果发送 GET 请求，method 属性就可以省略
可选属性的语法与函数可选参数的语法一致，都使用 ? 来表示

type Config = {
  url: string
  method?: string
}

function myAxios(config: Config) {
  console.log(config)
}

使用类型别名

注意：直接使用 {} 形式为对象添加类型，会降低代码的可读性（不好辨识类型和值）
推荐：使用类型别名为对象添加类型

// 创建类型别名
type Person = {
  name: string
  sayHi(): void
}

// 使用类型别名作为对象的类型：
let person: Person = {
  name: 'jack',
  sayHi() {}
}

练习

使用 `axios({ ... })` 时，如果发送 GET 请求，
method 属性就可以省略

接口类型

基本使用

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

解释：
1. 使用 interface 关键字来声明接口
2. 接口名称(比如，此处的 IPerson)，可以是任意合法的变量名称
3. 声明接口后，直接使用接口名称作为变量的类型
4. 因为每一行只有一个属性类型，因此，属性类型后没有 ;(分号)

/* 
    interface 用来描述对象的属性，与 type 是一样

    早期时候，并没有 type，使用 interface
    type：不仅可以描述对象的属性，还可以描述基本类型的属性
    interface： 仅仅可以描述对象的属性,在过去开发的框架上，使用比较多

    语法上有点不同
    等于号，分号
     type 类型 = {对象的描述;}
     interface 类型 {对象的描述}
*/

interface IPerson {
  name: string
  age: number
  sayHi(): void
}


let person: IPerson = {
  name: 'jack',
  age: 19,
  sayHi() {}
}

interface vs type

interface（接口）和 type（类型别名）的对比：
相同点：都可以给对象指定类型
不同点:
- 接口，只能为对象指定类型
- 类型别名，不仅可以为对象指定类型，实际上可以为任意类型指定别名
如何选择：按个人习惯，按团队风格都可以

interface IPerson {
  name: string
  age: number
  sayHi(): void
}

// 为对象类型创建类型别名
type IPerson = {
  name: string
  age: number
  sayHi(): void
}

// 为联合类型创建类型别名
type NumStr = number | string

接口继承

如果两个接口之间有相同的属性或方法，可以将公共的属性或方法抽离出来，通过 extends 继承来实现复用
比如，这两个接口都有 x、y 两个属性，重复写两次，可以，但很繁琐

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

更好的方式:

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

解释：
1. 使用 extends(继承)关键字实现了接口 Point3D 继承 Point2D
2. 继承后，Point3D 就有了 Point2D 的所有属性和方法(此时，Point3D 同时有 x、y、z 三个属性)

type实现继承

/* 
    interface继承，通过 extends 类型名 {要添加的属性}
    type 继承, 类型名 & {要添加的属性}
*/
{
  type Point2D = {
    x: number;
    y?: number;
  };

  type Point3D = Point2D & {
    z: number;
  };

  const point3D: Point3D = {
    x: 100,
    y: 100,
    z: 1,
  };
}

元组类型

场景：在地图中，使用经纬度坐标来标记位置信息
可以使用数组来记录坐标，那么，该数组中只有两个元素，并且这两个元素都是数值类型

let position: number[] = [113.2317, 23.5427]

使用 number[] 的缺点：不严谨，因为该类型的数组中可以出现任意多个数字
更好的方式：元组 Tuple
元组类型是另一种类型的数组，它确切地知道包含多少个元素，以及特定索引对应的类型

let position: [number, number] = [113.2317, 23.5427]

解释：
1. 元组类型可以确切地标记出有多少个元素，以及每个元素的类型
2. 该示例中，元素有两个元素，每个元素的类型都是 number

字面量类型

基本使用

思考以下代码，两个变量的类型分别是什么?

let str1 = 'Hello TS'
const str2 = 'Hello TS'

通过 TS 类型推论机制，可以得到答案：
1. 变量 str1 的类型为：string
2. 变量 str2 的类型为：'Hello TS'
解释:

str1 是一个变量(let)，它的值可以是任意字符串，所以类型为:string
str2 是一个常量(const)，它的值不能变化只能是 'Hello TS'，所以，它的类型为:'Hello TS'

注意：此处的 'Hello TS'，就是一个字面量类型，也就是说某个特定的字符串也可以作为 TS 中的类型
任意的 JS 字面量（比如，对象、数字等）都可以作为类型使用
- 字面量： 18 20 'abc' false { name: 'jack' } [] function() {}

使用模式和场景

使用模式：字面量类型配合联合类型一起使用
使用场景：用来表示一组明确的可选值列表

/* 
    字面量类型 通常配合 联合类型 去使用
    应用场景非常广，用户性别选择，methods方法，组件按钮大小颜色等
*/

type Gender = "男" | "女" | "未知";
let gender: Gender = "男";
gender = "未知";
// gender = "外星人";  // 报错

type Methods = "POST" | "GET" | "PUT" | "DELETE" | "get";

优势：相比于 string 类型，使用字面量类型更加精确、严谨

枚举类型

基本使用

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

// 创建枚举
enum 枚举名 { 
    枚举项 = 枚举值,
    枚举项 = 枚举值, 
}

解释:
1. 使用 enum 关键字定义枚举
2. 约定枚举名称以大写字母开头
3. 枚举中的多个值之间通过 ,（逗号）分隔
4. 定义好枚举后，直接使用枚举名称作为类型注解

数字枚举

注意：枚举成员是有值的，默认为：从 0 开始自增的数值
我们把，枚举成员的值为数字的枚举，称为：数字枚举
当然，也可以给枚举中的成员初始化值

export {}
/* 
    枚举类型：
    定义一组已知的可选项
    语法：
    enum 类型名 {
      枚举项 = 枚举值,
      枚举项 = 枚举值
    }

      ✅开发需求：
      用户编辑界面，用户选择的性别    男  女  未知
      后端接口参数要求传的是数字对应为 1   0  -1

    🎉开发经验：
      TS项目中可通过设计枚举结构，提高源代码的可读性
*/

enum Gender {
  Boy = 1,
  Girl = 0,
  UnKnown = -1,
}

const query = {
  name: '张三',
  // gender: Gender.Boy 等价于 gender: 1，🔔但代码可读性更高
  gender: Gender.Boy,
}

console.log('后端所需的参数', query)

字符串枚举-了解即可

字符串枚举：枚举成员的值是字符串
注意：字符串枚举没有自增长行为，因此，字符串枚举的每个成员必须有初始值
建议还是使用 字面量类型 + 联合类型 替代字符串枚举

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

枚举实现原理

枚举是 TS 为数不多的非 JavaScript 类型级扩展(不仅仅是类型)的特性之一
因为：其他类型仅仅被当做类型，而枚举不仅用作类型，还提供值(枚举成员都是有值的)
也就是说，其他的类型会在编译为 JS 代码时自动移除。但是，枚举类型会被编译为 JS 代码

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

// 会被编译为以下 JS 代码：
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 类型的情况
1. 声明变量不提供类型也不提供默认值
2. 函数参数不加类型
注意：因为不推荐使用 any，所以，这两种情况下都应该提供类型

类型断言

作用：十分肯定的说，它是一个什么类型

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

const aLink = document.getElementById('link')

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

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

解释:
1. 使用 as 关键字实现类型断言
2. 关键字 as 后面的类型是一个更加具体的类型（HTMLAnchorElement 是 HTMLElement 的子类型）
3. 通过类型断言，aLink 的类型变得更加具体，这样就可以访问 a 标签特有的属性或方法了
另一种语法，使用 <> 语法，这种语法形式不常用知道即可:

// 该语法，知道即可：
const aLink = <HTMLAnchorElement>document.getElementById('link')

TypeScript泛型

泛型-基本介绍

作用：理解为是一个函数，将类型当做参数传递

// 基本写法
const arr: number[] = [1, 2, 3, 4];
// 泛型写法
const arr2: Array<number> = [1, 2, 3, 4];

需求：创建一个 id 函数，传入什么数据就返回该数据本身

const fn1 = (value: number): number => {
  return value;
};

比如，id(10) 调用以上函数就会直接返回 10 本身。但是，该函数只接收数值类型，无法用于其他类型
为了能让函数能够接受任意类型，可以将参数类型修改为 any。但是，这样就失去了 TS 的类型保护，类型不安全

const fn1 = (value: any): any => {
  return value;
};

泛型在保证类型安全(不丢失类型信息)的同时，可以让函数等与多种不同的类型一起工作，灵活可复用

泛型-泛型函数

定义泛型函数

const id = <T>(value: T): T => {
  return value;
};

解释:
1. 语法：在函数名称的后面添加 <>(尖括号)，尖括号中添加类型变量，比如此处的 T
2. 类型变量 T，是一种特殊类型的变量，它处理类型而不是值
3. 该类型变量相当于一个类型容器，能够捕获用户提供的类型(具体是什么类型由用户调用该函数时指定)
4. 因为 T 是类型，因此可以将其作为函数参数和返回值的类型，表示参数和返回值具有相同的类型
5. 类型变量 T，可以是任意合法的变量名称

调用泛型函数

const num = id<number>(10)
const str = id<string>('a')

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

简化泛型函数调用 - 建议使用

// 省略 <number> 调用函数
let num = id(10)
let str = id('a')

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

练习题：

1. 需求： 封装一个函数，传入数组，返回数组第一项（可能是 number/string/boolean 等）
2. 需求： 封装一个函数，交换数组两项的位置（可能是 number/string/boolean 等）

泛型约束

默认情况下，泛型函数的类型变量 Type 可以代表多个类型，这导致无法访问任何属性
比如，id('a') 调用函数时获取参数的长度：

function id<Type>(value: Type): Type {
  console.log(value.length)
  return value
}

id('a')

解释：Type 可以代表任意类型，无法保证一定存在 length 属性，比如 number 类型就没有 length
此时，就需要为泛型添加约束来收缩类型(缩窄类型取值范围)
添加泛型约束收缩类型，主要有以下两种方式：1 指定更加具体的类型 2 添加约束

指定更加具体的类型

比如，将类型修改为 T[](T 类型的数组)，因为只要是数组就一定存在 length 属性，因此就可以访问了

function id<T>(value: T[]): T[] {
  console.log(value.length)
  return value
}

添加约束

// 创建一个接口
interface ILength {
  length: number;
}

// T extends ILength 添加泛型约束
// 解释：表示传入的 类型 必须满足 ILength 接口的要求才行，也就是得有一个 number 类型的 length 属性
function fn<T extends ILength>(val: T): T {
  console.log(val.length);
  return val;
}

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

泛型接口

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

// 定义泛型接口
interface Res<T> {
  msg: string;
  code: number;
  result: T;
}

// 传递具体的类型
const res: Res<number[]> = {
  msg: "成功",
  code: 200,
  result: [1, 2, 3],
};

res.result.push(4);

解释:
1. 在接口名称的后面添加 <泛型>，那么，这个接口就变成了泛型接口。
2. 接口的类型变量，对接口中所有其他成员可见，也就是接口中所有成员都可以使用类型变量。
3. 使用泛型接口时，需要显式指定具体的类型(比如，此处的 Res<number[]> )。

练习题：

一般后台返回的数据 res 中，result 是数组或者null，数组每一项是一个固定的结构对象，
{id:1,name:"吃饭",done:false}
封装符合的 Res 泛型接口

补充-多个泛型变量和泛型类型默认值

// 多泛型变量
const fn = <T, U>(a: T, b: U) => {};
fn(1, "2");
fn("2", 1);

// 泛型默认值
//泛型默认值
 //unknown   ----------对应js的 undefined
 // 一般使用场景，用在 对象 的泛型封装中

// 和JS 很像，add(a){}   现在的形参a，默认值是 undefined
const fn1 = <T = unknown>(a: T) => {};
fn1(1);

泛型练习题

泛型的类型变量可以有多个，并且类型变量之间还可以约束(比如，第二个类型变量受第一个类型变量约束)，

比如，创建一个函数来获取对象中属性的值：

getProp({ name: 'jack', age: 18 }, 'name')
// 返回 jack

keyof 关键词

关键字接收一个对象类型，生成其键名称字符串的联合类型

/* 
  keyof 获取对象类型的 键 名称, 生成所有 键 组成的字符串联合类型
*/

interface Person {
  name: string;
  age: number;
  gender: string;
}

const str: keyof Person = "gender";
// 两行代码是等价的
const myStr: "name" | "age" | "gender" = "gender";

解释:
1. 使用了两个类型变量 T,K ,类型变量之间使用 , 逗号分隔。
2. keyof 关键字接收一个对象类型，生成其键名称字符串的联合类型。
3. 本示例中 keyof T 实际上获取的是对象所有键的联合类型，也就是：'name' | 'age'
4. 类型变量 K 受 T 约束，可以理解为：K 只能是 T 所有键中的任意一个

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

TypeScript与Vue

参考链接：vuejs.org/guide/types…

中文链接：staging-cn.vuejs.org/guide/types…

vue3配合ts中，还需要额外安装一个vscode插件：Typescript Vue Plugin

defineProps与Typescript

目标：掌握defineProps如何配合ts使用

defineProps配合vue默认语法进行类型校验（运行时声明）

// 运行时声明
defineProps({
  money: {
    type: Number,
    required: true
  },
  car: {
    type: String,
    required: true
  }
})

defineProps配合ts的泛型定义props类型校验，这样更直接

/* 
    TS 的写法
    1. 调用 defineProps ，把泛型参数(描述父组件的props的类型) 传递，返回数据
    2. 解构返回来的数据，并且加上默认值
        注意：要使用这个功能，要在 vite.config.js 里面开启
        vue({
            reactivityTransform: true,
        })
        开启后，需要重启服务
*/
const { money, car = "五菱宏光" } = defineProps<{
    money: number,
    car?: string
}>()

</script>

<template>
    <h2>子组件 - {{ money }} - {{ car }}</h2>
</template>

<style scoped>
</style>

props可以通过解构来指定默认值

<script lang="ts" setup>
// 使用ts的泛型指令props类型
const { money, car = '小黄车' } = defineProps<{
  money: number
  car?: string
}>()
</script>

如果提供的默认值需要在模板中渲染，需要额外添加配置

vuejs.org/guide/extra…

// vite.config.js
export default {
  plugins: [
    vue({
      reactivityTransform: true
    })
  ]
}

defineEmits与Typescript

目标：掌握defineEmit如何配合ts使用

defineEmits配合运行时声明

const emit = defineEmits(['change', 'update'])

defineEmits配合ts 类型声明，可以实现更细粒度的校验

const emit = defineEmits<{
  (e: 'changeMoney', money: number): void
  (e: 'changeCar', car: string): void
}>()

ref与Typescript

目标：掌握ref配合ts如何使用

通过泛型指定value的值类型，如果是简单值，该类型可以省略

const money = ref<number>(10)

const money = ref(10)

如果是复杂类型，推荐指定泛型

type Todo = {
  id: number
  name: string
  done: boolean
}
const list = ref<Todo[]>([])

setTimeout(() => {
  list.value = [
    { id: 1, name: '吃饭', done: false },
    { id: 2, name: '睡觉', done: true }
  ]
})

computed与Typescript

目标：掌握computed配合typescript如何使用

通过泛型可以指定computed计算属性的类型，通常可以省略

const leftCount = computed<number>(() => {
  return list.value.filter((item) => item.done).length
})
console.log(leftCount.value)

事件处理与Typescript

目标：掌握事件处理函数配合typescript如何使用

const move = (e: MouseEvent) => {
  mouse.value.x = e.pageX
  mouse.value.y = e.pageY
}

<h1 @mousemove="move($event)">根组件</h1>

Template Ref与Typescript

目标：掌握ref操作DOM时如何配合Typescript使用

const imgRef = ref<HTMLImageElement | null>(null)

onMounted(() => {
  console.log(imgRef.value?.src)
})

如何查看一个DOM对象的类型：通过控制台进行查看

document.createElement('img').__proto__

可选链操作符

目标： 掌握js中的提供的可选链操作符语法，只能读取，不能赋值

内容

可选链操作符( ?. )允许读取位于连接对象链深处的属性的值，而不必明确验证链中的每个引用是否有效。
参考文档：developer.mozilla.org/zh-CN/docs/…

let nestedProp = obj.first?.second;
console.log(res.data?.data)
obj.fn?.()

if (obj.fn) {
    obj.fn()
}
obj.fn && obj.fn()

// 等价于
let temp = obj.first;
let nestedProp = ((temp === null || temp === undefined) ? undefined : temp.second);

非空断言

目标： 掌握ts中的非空断言的使用语法

内容：

如果我们明确的知道对象的属性一定不会为空，那么可以使用非空断言 !

// 告诉typescript, 明确的指定obj不可能为空
let nestedProp = obj!.second;

注意：非空断言一定要确保有该属性才能使用，不然使用非空断言会导致bug

使用axios接收后台返回数据，渲染到页面中

目标： 掌握 ts 中 axios 的用法

内容：向后台发请求，拿回栏目的数据，渲染到页面中

请求地址：http://xxx

<script setup lang="ts">
import axios from "axios"
import { ref } from "vue";

interface List {
    id: number,
    name: string
}
const list = ref<List[]>([])


const getList = async () => {
	// js的写法, axios不 支持对 返回数据做校验
	// ts的写法, axios.request 支持对 返回数据做校验
    const res = await axios.request({
        url: "http://xxx"
    })
    console.log('res', res);
    list.value = res.data.data.channels
}
getList()

</script>

<template>
    <ul class="nav">
        <!-- 模板中渲染 -->
        <li v-for="item in list" :key="item.id" :class="{ active: item.id === 0 }">{{ item.name }}</li>

    </ul>
</template>

<style>
* {
    margin: 0;
    padding: 0;
}

li {
    list-style: none;
}

.nav {
    display: flex;
    width: 100%;
    flex-wrap: nowrap;
    overflow: auto;
}

.nav li {
    padding: 10px;
    flex-shrink: 0;
}

.nav li.active {
    border-bottom: 3px solid #f30;
}
</style>

TypeScript类型声明文件(了解即可)

基本介绍

今天几乎所有的 JavaScript 应用都会引入许多第三方库来完成任务需求。这些第三方库不管是否是用 TS 编写的，最终都要编译成 JS 代码，才能发布给开发者使用。我们知道是 TS 提供了类型，才有了代码提示和类型保护等机制。

但在项目开发中使用第三方库时，你会发现它们几乎都有相应的 TS 类型，这些类型是怎么来的呢? 类型声明文件

类型声明文件：用来为已存在的 JS 库提供类型信息
TS 中有两种文件类型：1 .ts 文件 2 .d.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 都提供了声明文件
比如，在使用数组时，数组所有方法都会有相应的代码提示以及类型信息:

const strs = ['a', 'b', 'c']
// 鼠标放在 forEach 上查看类型
strs.forEach

实际上这都是 TS 提供的内置类型声明文件
可以通过 Ctrl + 鼠标左键(Mac：Command + 鼠标左键)来查看内置类型声明文件内容
比如，查看 forEach 方法的类型声明，在 VSCode 中会自动跳转到 lib.es5.d.ts 类型声明文件中
当然，像 window、document 等 BOM、DOM API 也都有相应的类型声明(lib.dom.d.ts)

第三方库类型声明文件

目前，几乎所有常用的第三方库都有相应的类型声明文件
第三方库的类型声明文件有两种存在形式:1 库自带类型声明文件 2 由 DefinitelyTyped 提供。

库自带类型声明文件：比如，axios

查看 node_modules/axios 目录

解释：这种情况下，正常导入该库，TS 就会自动加载库自己的类型声明文件，以提供该库的类型声明。

由 DefinitelyTyped 提供

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

import _ from 'lodash'

// 在 VSCode 中，查看 'lodash' 前面的提示

解释：当安装 @types/* 类型声明包后，TS 也会自动加载该类声明包，以提供该库的类型声明
补充：TS 官方文档提供了一个页面，可以来查询 @types/* 库
@types/* 库

自定义类型声明文件

项目内共享类型

如果多个 .ts 文件中都用到同一个类型，此时可以创建 .d.ts 文件提供该类型，实现类型共享。
操作步骤:
1. 创建 index.d.ts 类型声明文件。
2. 创建需要共享的类型，并使用 export 导出(TS 中的类型也可以使用 import/export 实现模块化功能)。
3. 在需要使用共享类型的 .ts 文件中，通过 import 导入即可(.d.ts 后缀导入时，直接省略)。

为已有 JS 文件提供类型声明

在将 JS 项目迁移到 TS 项目时，为了让已有的 .js 文件有类型声明。
成为库作者，创建库给其他人使用。

演示:基于最新的 ESModule(import/export)来为已有 .js 文件，创建类型声明文件。

类型声明文件的使用说明

说明:TS 项目中也可以使用 .js 文件。
说明:在导入 .js 文件时，TS 会自动加载与 .js 同名的 .d.ts 文件，以提供类型声明。
declare 关键字:用于类型声明，为其他地方(比如，.js 文件)已存在的变量声明类型，而不是创建一个新的变量。
1. 对于 type、interface 等这些明确就是 TS 类型的(只能在 TS 中使用的)，可以省略 declare 关键字。
2. 对于 let、function 等具有双重含义(在 JS、TS 中都能用)，应该使用 declare 关键字，明确指定此处用于类型声明。

let count = 10
let songName = '痴心绝对'
let position = {
  x: 0,
  y: 0
}

function add(x, y) {
  return x + y
}

function changeDirection(direction) {
  console.log(direction)
}

const fomartPoint = point => {
  console.log('当前坐标：', point)
}

export { count, songName, position, add, changeDirection, fomartPoint }

定义类型声明文件

declare let count:number

declare let songName: string

interface Position {
  x: number,
  y: number
}

declare let position: Position

declare function add (x :number, y: number) : number

type Direction = 'left' | 'right' | 'top' | 'bottom'

declare function changeDirection (direction: Direction): void

type FomartPoint = (point: Position) => void

declare const fomartPoint: FomartPoint

export {
  count, songName, position, add, changeDirection, FomartPoint, fomartPoint
}

TypeScript的简单入门并结合vue3进行使用

TypeScript基本概念

TypeScript 是什么？

为什么要有typescript

安装编译 TS 的工具包

编译并运行 TS 代码

创建基于TS的vue项目

TypeScript基础

类型注解

TypeScript类型概述

TypeScript原始数据类型

数组类型

联合类型

类型别名

函数类型

基本使用

类型别名写法

void 类型

可选参数

默认参数

类型推论

对象类型

基本使用

箭头函数形式的方法类型

对象可选属性

使用类型别名

练习

接口类型

基本使用

interface vs type

接口继承

type实现继承

元组类型

字面量类型

基本使用

使用模式和场景

枚举类型

基本使用

数字枚举

字符串枚举-了解即可

枚举实现原理

any 类型

类型断言

TypeScript泛型

泛型-基本介绍

作用：理解为是一个函数，将类型当做参数传递

泛型-泛型函数

简化泛型函数调用 - 建议使用

泛型约束

指定更加具体的类型

添加约束

泛型接口

补充-多个泛型变量 和 泛型类型默认值

泛型练习题

keyof 关键词

TypeScript与Vue

defineProps与Typescript

defineEmits与Typescript

ref与Typescript

computed与Typescript

事件处理与Typescript

Template Ref与Typescript

可选链操作符

非空断言

使用axios接收后台返回数据，渲染到页面中

TypeScript类型声明文件(了解即可)

基本介绍

内置类型声明文件

第三方库类型声明文件

自定义类型声明文件

补充-多个泛型变量和泛型类型默认值