[JavaScript知识库]TypeScript(四)

泛型

泛型是可以在保证类型安全的前提下，让函数等与多种类型一起工作从而实现复用，常用于：函数、接口、class中。

• 实现一个函数，传入什么数据就返回该数据本身（也就是说，参数和返回值类型相同）

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

缺点：以上函数只接受数值类型，无法用于其他类型

function num (val: any): any {
	return val
}

缺点：失去了TS的类型保护，类型不安全
泛型在保证类型安全（不丢失类型信息）的同时，可以让函数等与多种不同的类型一起工作，灵活可复用。

泛型的基本使用

• 创建泛型函数

function num<T>(val: T) {
  return val
}

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

• 调用泛型函数

function num<T>(val: T) {
  return val
}

const data: number = num<number> (100)
const str: string = num<string>('100')

2. 当传入类型后，这个类型就会被函数声明时指定的类型变量T捕获到

• 简化调用泛型函数

使用类型推断的机制简化其调用

function num<T>(val: T) {
  return val
}

let data1 = num(10)
let str1 = num('10')

泛型约束

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

function num<T>(val: T) {
  console.log(val.length) //报错 类型“T”上不存在属性“length”。
  return val
}

指定更加具体的类型

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

添加约束

interface ILength {length: number}
function num<T extends ILength>(val: T) {
  console.log(val.length) 
  return val
}

2. 通过 extends 关键字使用该接口，为泛型（类型变量）添加约束。
3. 该约束表示：传入的类型必须具有 length 属性。
注意：传入的实参（比如，数组）只要有 length 属性即可，这也符合前面讲到的接口的类型兼容性。

类型变量之间约束

泛型的变量可以有多个，并且类型变量之间还可以约束

function getProp<T, Key extends keyof T> (obj: T, key: Key) {
  return obj[key]
}
let person = {name: 'jack', age: 18}
getProp(person, 'name')

2. keyof 关键字接收一个对象类型，生成其键名称（可能是字符串或数字）的联合类型。
3. 本示例中 keyof T 实际上获取的是 person 对象所有键的联合类型，也就是：‘name’ | ‘age’。
4. 类型变量 Key 受 Type 约束，可以理解为：Key 只能是 T 所有键中的任意一个，或者说只能访问对象中存在的属性。

泛型接口

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

interface IdFun<T> {
  id: (value: T) => T
  ids: () => T[]
}

let obj: IdFun<number> = {
  id(value) {return value},
  ids() { return [1, 2, 3]}
}

2. 接口的类型变量，对接口中所有其他成员可见，也就是接口中所有成员都可以使用类型变量。
3. 使用泛型接口时，需要显式指定具体的类型（比如，此处的 IdFun）。
4. 此时，id 方法的参数和返回值类型都是 number；ids 方法的返回值类型是 number[]。

泛型类

泛型类： class也可以配合泛型来使用

interface IState {count: number} 
interface IProps {maxLength: number}
class InputCount  extends React.Component<IProps, IState> {
  state: IState = {
    count: 0
  }
  render() {
    return <div>{this.props.maxLength}</div>
  }
}

• React.Component 泛型类两个类型变量，分别指定 props 和 state 类型。

泛型工具类型

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

Partial< T >

泛型工具类型 - Partial<Type> 用来构造（创建）一个类型，将 Type 的所有属性设置为可选

interface Props {
  id: string
  children: number[]
}
type PartialProps = Partial<Props>
let p: PartialProps = {
  id: 'dsndj',
  // children: [1,2]
}

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

Readonly< T >

泛型工具类型 - Readonly<Type> 用来构造一个类型，将 Type 的所有属性都设置为 readonly（只读）。

interface Props {
  id: string
  children: number[]
}
type ReadlyProps = Readonly<Props>
let props: ReadlyProps = {id: '1', children: []}
props.id = '2' // 无法分配到 "id" ，因为它是只读属性。**

构造出来的新类型 ReadonlyProps 结构和 Props 相同，但所有属性都变为只读的。当我们想重新给 id 属性赋值时，就会报错：无法分配到 “id” ，因为它是只读属性。

Pick< T，Keys >

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

interface Props {
  id: string
  title: string
  children: number[]
}
type PickProps = Pick<Props, 'id' | 'title'>
let p: PickProps = {
  id: '2111',
  title: '6341',
  children: []  //对象文字可以只指定已知属性，并且“children”不在类型“PickProps”中。

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

Record< Keys，T >

泛型工具类型 - Record<Keys,Type> 构造一个对象类型，属性键为 Keys，属性类型为 Type。

type RecordObj = Record<'a' | 'b' | 'c', string[]>
let obj: RecordObj = {
  a: ['0'],
  b: ['0'],
  c: ['0']
}

1. Record 工具类型有两个类型变量：1 表示对象有哪些属性 2 表示对象属性的类型。
2. 构建的新对象类型 RecordObj 表示：这个对象有三个属性分别为a/b/c，属性值的类型都是 string[]。

索引签名类型

绝大多数情况下，我们都可以在使用对象前就确定对象的结构，并为对象添加准确的类型。

使用场景：当无法确定对象中有哪些属性（或者说对象中可以出现任意多个属性），此时，就用到索引签名类型了。

• 对象

interface AnyObj {
  [key: string]: number
}
let obj: AnyObj = {
  a: 1,
  b: 2,
  c: 3
}

1. 使用 [key: string] 来约束该接口中允许出现的属性名称。表示只要是 string 类型的属性名称，都可以出现在对象中。
2. 这样，对象 obj 中就可以出现任意多个属性（比如，a、b 等）。
3. key 只是一个占位符，可以换成任意合法的变量名称。
4. 隐藏的前置知识：JS 中对象（{}）的键是 string 类型的。

• 数组

在 JS 中数组是一类特殊的对象，特殊在数组的键（索引）是数值类型。
并且，数组也可以出现任意多个元素。所以，在数组对应的泛型接口中，也用到了索引签名类型。

interface MyArray<T> {
  [n: number]: T
}
let arr: MyArray<number> = [1, 2, 3]

1. MyArray 接口模拟原生的数组接口，并使用 [n: number] 来作为索引签名类型。
2. 该索引签名类型表示：只要是 number 类型的键（索引）都可以出现在数组中，或者说数组中可以有任意多个元素。
3. 同时也符合数组索引是 number 类型这一前提。

映射类型

映射类型：基于旧类型创建新类型（对象类型），减少重复、提升开发效率。

// 1.
type PropKey = 'x' | 'y' | 'z'
type Type1 = {x: number; y: number; z: number}

// 2.
type PropKeys = 'x' | 'y' | 'z'
type Type2 = {[Key in PropKeys]: number}

1. 映射类型是基于索引签名类型的，所以，该语法类似于索引签名类型，也使用了 []。
2. Key in PropKeys 表示 Key 可以是 PropKeys 联合类型中的任意一个，类似于 forin(let k in obj)。
3. 使用映射类型创建的新对象类型 Type2 和类型 Type1 结构完全相同。
4. 注意：映射类型只能在类型别名中使用，不能在接口中使用。

Partial< Type >的实现

泛型工具类型（比如，Partial<Type>）都是基于映射类型实现的。

/**
 * Make all properties in T optional
 */
 type Partial<T> = {
  [P in keyof T]?: T[P];
};
type Props = {a: number; b:string; c: boolean}
type PartialProps = Partial<Props>

1. keyof T 即 keyof Props 表示获取 Props 的所有键，也就是：‘a’ | ‘b’ | ‘c’。
2. 在 [] 后面添加 ?（问号），表示将这些属性变为可选的，以此来实现 Partial 的功能。
3. 冒号后面的 T[P] 表示获取 T 中每个键对应的类型。比如，如果是 ‘a’ 则类型是 number；如果是 ‘b’ 则类型是 string。
4. 最终，新类型 PartialProps 和旧类型 Props 结构完全相同，只是让所有类型都变为可选了。

索引查询（访问）类型

以上的T[P] 语法，在 TS 中叫做索引查询（访问）类型。

type Props = {a: number; b:string; c: boolean}
type TypeA = number
type TypeA = Props['a']

Props[‘a’] 表示查询类型 Props 中属性 ‘a’ 对应的类型 number。所以，TypeA 的类型为 number。
[] 中的属性必须存在于被查询类型中，否则就会报错。

• 同时查询多个索引的类型

type Props = {a: number; b:string; c: boolean}
type TypeA = Props['a' | 'b'] // string | number
let a:TypeA = 1
let b:TypeA = '1'

使用字符串字面量的联合类型，获取属性 a 和 b 对应的类型，结果为： string | number。

type Props = {a: number; b:string; c: boolean}
type TypeA = Props[keyof Props] // string | number | boolean

使用 keyof 操作符获取 Props 中所有键对应的类型，结果为： string | number | boolean。