// 定义枚举类型
enum Direction { Up, Down, Left, Right }

// 使用枚举类型
function changeDirection(direction: Direction) {
  console.log(direction)
}

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

解释:

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

枚举的值

枚举类型和ts中其他的类型不一样，枚举类型不仅仅是类型，还是一个值。

type定义的类型是没有值的

type NewType = number | string
console.log(NewType) // 输出类型是没有意义的

枚举定义的类型是有值的。

数字枚举

默认情况下，枚举的值是数值。默认为：从 0 开始自增的数值

当然，也可以给枚举中的成员初始化值

// Down -> 11、Left -> 12、Right -> 13
enum Direction { Up = 10, Down, Left, Right }

enum Direction { Up = 2, Down = 4, Left = 8, Right = 16 }

字符串枚举

字符串枚举：枚举成员的值是字符串

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

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

小结

枚举与前面讲到的字面量类型+联合类型组合的功能类似，都用来表示一组明确的可选值列表
一般情况下，推荐使用字面量类型+联合类型组合的方式，因为相比枚举，这种方式更加直观、简洁、高效

枚举类型的应用

后端用0,1来标识性别，但是0，1在代码中不好读。

enum Gender {
        girl,
        boy
    }
    type User = {
        name: string,
        gender: Gender
    }

    const u1: User = {
        name: '小花',
        gender: Gender.girl
    }

    console.log(u1)

any 类型

定义及作用

any: 任意的。当类型设置为 any 时，就取消了类型的限制。

let obj: any = { x: 0 }

obj.bar = 100
obj()
const n: number = obj

解释: 以上操作都不会有任何类型错误提示，即使可能存在错误（编译时不报错，可是运行时会报错）

使用any的场景

函数就是不挑类型。例如，console.log() ；定义一个函数，输入任意类型的数据，返回该数据类型
临时使用 any 来“避免”书写很长、很复杂的类型

隐式 any

声明变量不提供类型也不提供默认值
定义函数时，参数不给类型

小结

原则:不推荐使用 any!这会让 TypeScript 变为 “AnyScript”(失去 TS 类型保护的优势)

类型断言

假设我们明确知道页面上有一个img，它的id是img。

const box = document.getElementById('img')
console.log(box.src) // ts报错

注意：该方法返回值的类型是 HTMLElement，该类型只包含所有标签公共的属性或方法，不包含 img 标签特有的 src等属性，无法操作 src 等 img标签特有的属性或方法。

类型断言的作用和应用场景

作用：手动指定值的类型

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

格式

关键字： as

const 变量 = 值 as 类型

解释:

使用 as 关键字实现类型断言
关键字 as 后面的类型是一个更加具体的类型（HTMLAnchorElement 是 HTMLElement 的子类型）

示例1

const box = document.getElementById('img') as HTMLImageElement

box.src

示例2

知道后端的结果会是一个类型，但这个结果是用ajax拿到的，不好直接给初始值，又希望得到输出提示的效果

type User = {
  name: string,
  age: number
}

const u1 = {} as User

console.log(u1.name) // 这里就会有提示

typeof

res表示一个复杂的对象，我们把它传给一个函数fn，但是目前没有办法从形参obj中获取提示信息

const res = { name: '小花', city: '武汉',  skills: ['js', 'css'] }

function fn(obj) {
  // 这里写obj.没有提示
  // obj.
}

fn(res)

JS 中提供了 typeof 操作符，用来在 JS 中获取数据的类型

console.log(typeof 'Hello world') // ?

TS 也提供了 typeof 操作符：可以在类型上下文中引用变量或属性的类型（类型查询）

使用场景

根据已有变量的值，反向推断出获取该值的类型，来简化类型书写

格式

type 类型 = typeof 常量

示例

const res = { name: '小花', city: '武汉',  skills: ['js', 'css'] }

type Stu = typeof res

function fn(obj:Stu) {
    // 这里写 obj. 就会有提示
    obj.skills
}

fn(res)

解释:

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

泛型-基本介绍

需求

创建一个 fn 函数，它的特点是：传入什么类型的数据就返回什么类型的数据。也就是说，参数和返回值类型相同。

function fn(value: number): number { return value }

比如，fn(10) 调用以上函数就会直接返回 10 本身。但是，该函数声明只接收数值类型，无法用于其他类型

any 能做到么？

function fn(value: any): any { return value }

不能。它没有了类型保护，也没有严格限制返回值的类型和输入值的类型一致。

泛型

泛型，顾名思义，就是可以适用于多个类型，使用类型变量比如T帮助我们捕获传入的类型，之后我们就可以继续使用这个类型。

本质是参数化类型，通俗的将就是所操作的数据类型被指定为一个参数，这种参数类型可以用在类、接口和函数的创建中，分别成为泛型类，泛型接口、泛型函数

泛型函数

创建泛型函数的格式

function fn<Type>(value: Type): Type { return value }
// 上面的Type只是一个名字而已，可以改成其他的

function fn<T>(value: T): T { return value }

语法：在函数名称的后面写 <>(尖括号)，尖括号中添加类型变量，比如此处的 Type。

类型变量 Type，是一种特殊类型的变量，它处理类型而不是值
该类型变量相当于一个类型容器，能够捕获用户提供的类型(具体是什么类型由用户调用该函数时指定)
因为 Type 是类型，因此可以将其作为函数参数和返回值的类型，表示参数和返回值具有相同的类型
类型变量 Type，可以是任意合法的变量名称

调用泛型函数的格式

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

语法：在函数名称的后面添加 <>(尖括号)，尖括号中指定具体的类型，比如，此处的 number
当传入类型 number 后，这个类型就会被函数声明时指定的类型变量 Type 捕获到
此时，Type 的类型就是 number，所以，函数fn参数和返回值的类型也都是 number

同样，如果传入类型 string，函数 id 参数和返回值的类型就都是 string
这样，通过泛型就做到了让 id 函数与多种不同的类型一起工作，实现了复用的同时保证了类型安全

类型推断简化函数调用

function fn<T>(value: T): T { return value }


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

在调用泛型函数时，可以省略 <类型> 来简化泛型函数的调用
此时，TS 内部会采用一种叫做类型参数推断的机制，来根据传入的实参自动推断出类型变量 Type 的类型
比如，传入实参 10，TS 会自动推断出变量 num 的类型 number，并作为 Type 的类型

推荐：使用这种简化的方式调用泛型函数，使代码更短，更易于阅读
说明：当编译器无法推断类型或者推断的类型不准确时，就需要显式地传入类型参数

案例

下面的react代码对我们理解泛型有帮助

// js
const [num, setNum] = useState(10)

// ts, 用泛型指定类型
const [num, setNum] = useState<number>(10)

cont inputRef = useRef(null)
const onClick = () => {
  console.log(inputRef.current.value) // ts在这里会报错
}

<input type="text" ref={inputRef} />

改正
cont inputRef = useRef<HTMLInputElement>(null)
const onClick = () => {
  console.log(inputRef.current.value) // 正确
}

泛型约束

默认情况下，泛型函数的类型变量 T 可以代表多个类型，这导致无法访问任何属性

比如，fn('a') 调用函数时获取参数的长度：

function fn<T>(value: T): T {
  // 这里value. 不会有提示
  console.log(value.length)// 这里会报错
  return value
}

fn('a')

解释：Type 可以代表任意类型，无法保证一定存在 length 属性，比如 number 类型就没有 length
此时，就需要为泛型添加约束来收缩类型(缩窄类型取值范围)

添加泛型约束

添加泛型约束收缩类型，主要有以下两种方式：

指定更加具体的类型
添加约束

指定更加具体的类型

比如，：可以接收任意类型的数组。

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

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

添加约束

比如，要求传入T类型必须要有length属性

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

// T extends ILength 添加泛型约束
function fn<T extends ILength>(value: T): T {
  console.log(value.length)
  return value
}

fn('abc') // Ok
fn([1,2,3]) // Ok

解释:

创建描述约束的接口 ILength，该接口要求提供 length 属性
通过 extends 关键字使用该接口，为泛型(类型变量)添加约束
该约束表示：传入的类型必须具有 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')

解释:

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

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

getProperty({a:1, b:2}, 'a')

泛型接口

在接口中使用泛型来使用，以增加其灵活性，增强其复用性

interface MyArray {
  length: number,
  push(n: number):void,
  pop():number,
  reverse():number[]
}

let obj: MyArray = {
  id(value) { return value },
  ids() { return [1, 3, 5] }
}

定义

interface 接口名<类型变量> {
  
}

在接口名称的后面添加 <类型变量>，那么，这个接口就变成了泛型接口。
接口的类型变量，对接口中所有其他成员可见，也就是接口中所有成员都可以使用类型变量。
使用泛型接口时，需要显式指定具体的类型

实际上，JS 中的数组在 TS 中就是一个泛型接口

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

const nums = [1, 3, 5]
// 鼠标放在 forEach 上查看类型
nums.forEach

解释:当我们在使用数组时，TS 会根据数组的不同类型，来自动将类型变量设置为相应的类型
技巧:可以通过 Ctrl + 鼠标左键(Mac：Command + 鼠标左键)来查看具体的类型信息

泛型工具类型

泛型工具类型:TS 内置了一些常用的工具类型，来简化 TS 中的一些常见操作

说明:它们都是基于泛型实现的(泛型适用于多种类型，更加通用)，并且是内置的，可以直接在代码中使用。这些工具类型有很多，先来学习以下3个:

Partial<Type>
Readonly<Type>
Pick<Type, Keys>

Partial

Partial用来基于某个Type来创建一个新类型，新类型中所有的属性是可选的。

格式


type OldType = {}
type newType = Partial(OldType)

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

type Props =  {
  id: string
  children: number[]
}

type PartialProps = Partial<Props>

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

Readonly

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

type Props =  {
  id: string
  children: number[]
}

type ReadonlyProps = Readonly<Props>

解释:构造出来的新类型 ReadonlyProps 结构和 Props 相同，但所有属性都变为只读的。

let props: ReadonlyProps = { id: '1', children: [] }
// 错误演示
props.id = '2'

当我们想重新给 id 属性赋值时，就会报错:无法分配到 "id" ，因为它是只读属性。

Pick

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

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

解释:

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

原文链接：https://blog.csdn.net/weixin_58726419/article/details/121545160