【TypeScript】基础入门（二）

原创已于 2022-09-28 14:14:47 修改 · 548 阅读

0 ·

CC 4.0 BY-SA版权

文章标签：

#typescript #javascript #前端

于 2022-02-21 20:22:30 首次发布

React 同时被 2 个专栏收录

5 篇文章

订阅专栏

TypeScript

5 篇文章

订阅专栏

本文详细介绍了TypeScript中的泛型，包括泛型函数、类型约束、多个类型变量的应用，以及泛型接口、工具类型和索引签名的使用。通过实例展示如何创建可复用组件并确保类型安全。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

在这里插入图片描述

系列文章目录

第一篇 TypeScript基础入门
 第二篇 TypeScript基础入门

泛型

介绍

软件工程中，我们不仅要创建一致的定义良好的API，同时也要考虑可重用性。组件不仅能够支持当前的数据类型，同时也能支持未来的数据类型，这在创建大型系统时为你提供了十分灵活的功能。

在像C#和Java这样的语言中，可以使用泛型来创建可重用的组件，一个组件可以支持多种类型的数据。这样用户就可以以自己的数据类型来使用组件。

作用：获取调用时的参数类型

type FindNameFnType = <T>(value: { name: T }) => T;
const findNameFn1: FindNameFnType = (obj) => obj.name;
const result1 = findNameFn1({ name: 'John' });
const result2 = findNameFn1({ name: 10086 });
// 简写
const findNameFn2: <T>(value: { name: T }) => T = (obj) => obj.name;
const result3 = findNameFn2({ name: 'John' });
const result4 = findNameFn2({ name: 10086 });
// ------------------------------------------------//

捕获数据类型：

type SetNameFnType = <T>(value: T) => { name: T };
const setNameFn: SetNameFnType = (name) => ({ name: name });
const obj1 = setNameFn(1);
const obj2 = setNameFn('2');
const obj3 = setNameFn(true);
const obj4 = setNameFn({ age: 25 });

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

需求：创建一个 fn 函数，传入什么数据就返回该数据本身(也就是说，参数和返回值类型相同)

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

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

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

一、泛型函数

1、创建泛型函数

function fn1<Type>(value: Type): Type {
  return value;
}
function fn2<T>(value: T): T {
  return value;
}

解释:

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

2、调用泛型函数

const num1 = fn1<number>(10);
console.log('num1', num1);
const num2 = fn2<string>('a');

解释：

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

3、简化泛型函数调用

省略调用函数

let num = fn1(10);
let str = fn2('a');

解释:

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

实现useState的泛型函数
1.要求count的类型，跟还有初始值的类型的来
2.要求setCount是一个函数，函数的参数类型，有初始值类型决定
3.最多只能解构两个元素

type UseStateType = <T>(initValue: T) => [T, (value: T) => void];
const useState: UseStateType = (initValue) => {
  const setValue = (params) => {
    // ...省略实现
  };
  return [initValue, setValue];
};

const [count, setCount] = useState(0);
setCount(1);
const [msg, setMsg] = useState('');
setMsg('1');
const [isShow, setIsShow] = useState(false);
setIsShow(true);

二、泛型约束

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

function fn1<T>(value: T): T {
  // console.log(value.length);  报错
  return value;
}
fn1('a');

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

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

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

1、指定更加具体的类型

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

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

2、添加约束

创建一个接口

// 两种写法：
/*
type ILength {
  length: number;
}
*/
interface ILength {
  length: number;
}

Type extends ILength 添加泛型约束
解释：表示传入的类型必须满足 ILength 接口的要求才行，也就是得有一个 number 类型的 length 属性

function fn3<T extends ILength>(value: T): T {
  console.log(value.length);
  return value;
}

解释:

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

注意:传入的实参(比如，数组)只要有 length 属性即可（类型兼容性)

三、多个类型变量

泛型的类型变量可以有多个，并且类型变量之间还可以约束(比如，第二个类型变量受第一个类型变量约束)；比如，创建一个函数来获取对象中属性的值：

// function getObjValue(obj,key) {
//  return obj[key]
// }
function getObjValue<T, K extends keyof T>(obj: T, key: K): T[K] {
  return obj[key];
}
const res1 = getObjValue({ name: 'John', age: 25 }, 'name');
console.log(res1);
const res2 = getObjValue({ name: 'Nick', age: 18 }, 'age');
console.log(res2);

当写为getObjValue({ name: ‘zs’, age: 18 }, ‘gender’})就会报错：类型““gender””的参数不能赋给类型““name” | “age””的参数。

解释:

添加了第二个类型变量 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];
}

总结：keyof的作用，从结构中，提取所有的键，组成联合类型+字面量类型，表示一组可选的取值范围。
语法：keyof + 类型。

type FormDataType = {
  title: string;
  content: string;
  images: string[];
};
const formData: FormDataType = {
  title: '大厂招聘',
  content: '在线招聘中....',
  images: ['腾讯.png', '字节跳动.png', '阿里巴巴.png'],
};
function getValueByName(name: keyof FormDataType) {
  return formData[name];
}
getValueByName('content');

泛型类型的使用 - 了解即可，不常用
使用场景：描述大量相似的结构；泛型接口，调用时不能省略泛型；成员（属性和方法）都可以访问泛型接口中的泛型。

type MyPerson<T> = {
  name: string;
  sayHello: (msg: T) => T;
};
const John: MyPerson<string> = {
  name: 'John',
  sayHello(msg) {
    // console.log('msg  ----->  ', msg);
    return msg;
  },
};
John.sayHello('Hello!');

四、泛型接口

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

interface IdFunc<Type> {
  id: (value: Type) => Type;
  ids: () => Type[];
}
let obj: IdFunc<number> = {
  id(value) {
    return value;
  },
  ids() {
    return [1, 3, 5];
  },
};

解释:

在接口名称的后面添加 <类型变量>，那么，这个接口就变成了泛型接口。
接口的类型变量，对接口中所有其他成员可见，也就是接口中所有成员都可以使用类型变量。
使用泛型接口时，需要显式指定具体的类型(比如，此处的 IdFunc)。
此时，id 方法的参数和返回值类型都是 number;ids 方法的返回值类型是 number[]。

1、JS 中的泛型接口

//  实际上，JS 中的数组在 TS 中就是一个泛型接口。
const strs = ['a', 'b', 'c']; //JS 中的泛型接口
// 鼠标放在 forEach 上查看类型
strs.forEach;

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

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

forEach:
(method) Array.forEach(callbackfn: (value: string, index: number, array: string[]) => void, thisArg?: any): void

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

五、泛型工具类型

泛型工具类型:TS 内置了一些常用的工具类型，来简化 TS 中的一些常见操作；说明:它们都是基于泛型实现的(泛型适用于多种类型，更加通用)，并且是内置的，可以直接在代码中使用。这些工具类型有很多，主要学习以下几个:

Partial --属性转可选
Readonly --属性转只读
Pick<Type, Keys> --选取属性
Omit --删除属性

1. Partial --属性转可选

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

type Props = {
    id: string;
    children: number[];
    title?: string;
    image?: string[];
  };
  type PartialProps = Partial<Props>;
  const data: PartialProps = {
    id: '1',
    children: [1, 2, 3],
  };
  const dataId = data.children;
  console.log('Partial', dataId);

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

2、Readonly—属性转只读

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

 type Props = {
    id: string;
    children: number[];
  };
  type ReadonlyProps = Readonly<Props>;
  // 解释:构造出来的新类型 ReadonlyProps 结构和 Props 相同，但所有属性都变为只读的。
  let props: ReadonlyProps = { id: '1', children: [1, 2, 3] };
  console.log('Readonly', props);
  // 错误演示
  // props.id = '2';
  // 当我们想重新给 id 属性赋值时，就会报错:无法分配到 "id" ，因为它是只读属性。

3、Pick—选取属性

Pick的作用：从对象结构中，挑选出需要的字段，组成新的对象结构
Pick<Type, Keys> 从 Type 中选择一组属性来构造新类型。

interface Props {
  id: string;
  title: string;
  children: number[];
}
type PickProps = Pick<Props, 'id' | 'title'>;
const From1: PickProps = {
  id: '1',
  title: '今天放假',
};
console.log('Pick:', From1);

解释:

Pick 工具类型有两个类型变量:
1).表示选择谁的属性
2).表示选择哪几个属性。
3). 其中第二个类型变量，如果只选择一个则只传入该属性名即可。
第二个类型变量传入的属性只能是第一个类型变量中存在的属性。
构造出来的新类型 PickProps，只有 id 和 title 两个属性类型。
语法：Pick<对象结构，键名组成的联合类型>

4、Omit—删除属性

Omit的作用：从对象结构中，删除指定的字段，组成新的对象结构
Omit<K,T>类型让我们可以从另一个对象类型中剔除某些属性，并创建一个新的对象类型：
K：是对象类型名称，T：是剔除K类型中的属性名称

type UserProps = {
  name?: string;
  age?: number;
  sex?: string;
};
// 不希望有sex这个属性就可以这么写
type NewUserProps1 = Omit<UserProps, 'sex'>;
// 等价于
type NewUserProps2 = {
  name?: string;
  age?: string;
};
const From2: NewUserProps1 = {
  name: 'John',
  age: 25,
};
console.log('Omit:', From2);

语法：Omit<对象结构，删除的键名组成的联合类型>；对象结构：type与interface描述的对象结构都可以。

5、ReturnType
作用：提取函数返回值的类型
使用场景：当返回值类型特别复杂难以提取的时使用
语法： ReturnType<typeof 函数>

function test1(list: string[]) {
  return list.map((item) => ({
    a: {},
  }));
}
function test2(a: number, b: number) {
  return a + b;
}
const result2: ReturnType<typeof test2> = 2;
console.log(result2);

六、索引签名类型

绝大多数情况下，我们都可以在使用对象前就确定对象的结构，并为对象添加准确的类型。
使用场景:当无法确定对象中有哪些属性(或者说对象中可以出现任意多个属性)，此时，就用到索引签名类型了。

interface AnyObject {
  [key: string]: any;
}
let obj: AnyObject = {
  StuId: 1,
  ID: 2,
  Name: 'John',
  isDone: true,
};

解释:

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

1、数组索引类型签名

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

interface MyArray<T> {
  [key: number]: T;
}
let arr: MyArray<string> = ['1', '3', '5'];
console.log(arr);

解释:

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

七、映射类型

映射类型:基于旧类型创建新类型(对象类型)，减少重复、提升开发效率。比如，类型 PropKeys 有 x/y/z，另一个类型 Type1 中也有 x/y/z，并且 Type1 中 x/y/z 的类型相同:

  type PropKeys = 'x' | 'y' | 'z';
  type Type1 = { x: number; y: number; z: number };

这样书写没错，但 x/y/z 重复书写了两次。像这种情况，就可以使用映射类型来进行简化。

  type PropKeys = 'x' | 'y' | 'z';
  type Type2 = { [Key in PropKeys]: number };
  const data: Type2 = { x: 1, y: 2, z: 3 };
  console.log('映射类型', data);

解释:

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

1、根据对象创建

映射类型除了根据联合类型创建新类型外，还可以根据对象类型来创建:

  type Props = { a: number; b: string; c: boolean };
  type Type3 = { [key in keyof Props]: number };
  const data: Type3 = {
    a: 1,
    b: 2,
    c: 3,
  };
  console.log('根据对象创建', data);

解释:

首先，先执行 keyof Props 获取到对象类型 Props 中所有键的联合类型即，‘a’ | ‘b’ | ‘c’。
然后，Key in … 就表示 Key 可以是 Props 中所有的键名称中的任意一个。

2、内置映射类型实现分析

实际上，前面讲到的泛型工具类型(比如，Partial)都是基于映射类型实现的。
比如，Partial 的实现:

  type Partial<T> = {
    [P in keyof T]?: T[P];
  };
  type Props = { a: number; b: string; c: boolean };
  type PartialProps = Partial<Props>;
  const data: PartialProps = {
    a: 137,
    b: '5',
    c: true,
  };
  console.log('内置映射类型实现分析', data);

解释:

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

3、索引访问类型

刚刚用到的 T[P] 语法，在 TS 中叫做索引访问类型
作用:用来查询属性的类型。

  type Props = { a: number; b: string; c: boolean };
  type TypeA = Props['a'];
  const data: TypeA = 1;
  console.log('索引访问类型', data);

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

4、同时查询多个索引的类型

索引查询类型的其他使用方式:同时查询多个索引的类型

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

解释:使用字符串字面量的联合类型，获取属性 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。