27

写在开头

  • 我写了一年多 TypeScript ,总结了以下几个点,希望可以帮到大家
  • 如果感觉写得不错,记得来个 关注/在看

比较容易遇到的问题

给一个对象添加属性
interface Obj {
  a: string;
const obj: Obj = {
  a: "1",
obj.b = 2;
  • 此时会出现错误提示: 类型“Obj”上不存在属性“b”。
  • 要想解决这个问题,要使用索引签名
interface Obj {
  a: string;
  [index: string]: string | number;
const obj: Obj = {
  a: "1",
obj.b = 2;
  • 大家很好奇,为什么我这里会加入 [index: string]: string | number; ,类型是字符串或者数字。因为:
当你声明一个索引签名时,所有明确的成员都必须符合索引签名
函数重载
  • 场景:函数有多个参数,而且参数不确定时,函数运行逻辑不一致
// 重载
function padding(all: number);
function padding(topAndBottom: number, leftAndRight: number);
function padding(top: number, right: number, bottom: number, left: number);
// Actual implementation that is a true representation of all the cases the function body needs to handle
function padding(a: number, b?: number, c?: number, d?: number) {
  if (b === undefined && c === undefined && d === undefined) {
    b = c = d = a;
  } else if (c === undefined && d === undefined) {
    c = a;
    d = b;
  return {
    top: a,
    right: b,
    bottom: c,
    left: d
}
这样函数兼容 传 1、2、4个参数。 但是只要传三个,就会报错。
  • 函数重载最重要的是,最终声明(从函数内部看到的真正声明)与所有重载兼容(与上面的索引签名一致)
下载的第三方npm库没有ts声明文件
  • 例如:
npm i somePackage --save 
import somePackage from 'somePackage';
  • 但是此时提示: 找不到模块“somePackage”或其相应的类型声明。
  • 此时你可以在项目根目录下新建index.d.ts,编写如下代码:
declare module 'somePackage';
...
这个问题迎刃而解
泛型
  • 这个问题很容易困扰小白,其实泛型简单来说,就是一个 类型变量 ,如下所示:
class Peter {
  niubi<T>(a: T): T[] {
    return [a];
}
此时的T就是一个泛型,它是一个可变的类型。根据你传入 niubi 这个方法的参数对象来确定的,当我们传入的 a 是字符串,那么T就为 string .返回的就是一个 item 为字符串的数组
class Peter {
  niubi<T>(a: T): T[] {
    return [a];
const obj = new Peter();
let res = obj.niubi("hehe");
res = 1;
res = ["2"];

此时res = 1会报错 不能将类型“number”分配给类型“string[]” , 因为此时TS推断出来,res必定为一个数组,且里面的item是一个字符串.

res = ["2"] 则不会报错
  • 泛型可以说是TS里面的一个难点,但是其实它只是一个可变的类型变量。
  • 调整参数后:
let res2 = obj.niubi(2);
res2 = 2;
  • 会报错: 不能将类型“number”分配给类型“number[]”。
最后要记住的是,既然是类型变量。那么这个变量也可以是一个泛型。
class Peter {
  niubi<T>(a: T): T[] {
    return [a];
const obj = new Peter();
function test<T>(b: T): T {
  return b;
let res = obj.niubi(test(1));
  • 看到这里肯定有人会说,Peter你脱裤子放屁啊。这个还不如用any.那你再看下面这段代码,我们封装api请求的时候。
  • 首先定义好返回的接口。(返回的接口一般都是有统一的格式,状态码和result,data等)
// 请求接口数据
export interface ResponseData<T = any> {
   * 状态码
   * @type { number }
  code: number;
   * @type { T }
  result: T;
   * @type { string }
  message: string;
  • 这里的 data 数据是动态的格式,我们可以用泛型来定义。
  • 这里用了两次泛型,先定义好返回的 data 数据,再用泛型方式传入,组装好返回的整个返回数据接口(包含 code,result,data )。再接着传入到真正的请求函数中
// 在 axios.ts 文件中对 axios 进行了处理,例如添加通用配置、拦截器等
import Ax from './axios';
import { ResponseData } from './interface.ts';
export function getUser<T>() {
  return Ax.get<ResponseData<T>>('/somepath')
    .then(res => res.data)
    .catch(err => console.error(err));
}
  • 在真正的请求函数中使用了泛型,即传入任意类型参数 <T> ,那么便返回一个 Promise 风格的 Promise<T> 数据 :
const get = <T>(config: { url: string; headers?: { [key: string]: string } }): Promise<T> => {
  const fetchConfig = {
    method: 'GET',
    Accept: 'application/json',
    'Content-Type': 'application/json',
    ...(config.headers || {})
  return fetch(config.url, fetchConfig).then<T>(response => response.json());
};
总结两次泛型的连续使用:

1.使用 data 作为泛型,传入

2.组装成 {code,result,data} 这种类型接口

3.将第二步的组装后类型作为泛型 <T> 传入 get 方法中

4.返回一个 Promise 风格的 Promise<T> 数据

这样做的意义,提取可变的数据类型 data ,让TS推断出这个接口返回的数据是怎么样的。减少不必要的重复代码,即每次接口调取都会返回的数据格式类型: code result
  • 相信你通过这段代码和文字,能真正理解 TS 的泛型如何用,什么地方使用,以及使用的意义了。
颗粒度定义类型后的问题
  • 当我们颗粒度比较细定义了接口以后,可能存在接口复用的问题,例如:
interface test1 {
  a: string;
interface test2 {
  b: string;
  • 此时我想要定义一个两个属性都拥有的对象,那么可以使用联合类型。
const obj: test1 & test2 = {
  a: "1",
  b: "2",
};
  • 如果我想定义一个只有 a/b 的对象,可以使用
const obj: test1 | test2 = {
  a: "1",
};
可能有人会说,怎么会写这么简单的东西。
  • 这里是为了接下来的类型兼容性打基础,TS里面最重要的就是 type类型 ,类型系统就是它的核心。
  • 我们可以用两个不同的变量来互相赋值来检验,他们的类型是否兼容,例如:
interface Test1 {
  a: number;
  b: number;
  c: string;
interface Test2 {
  a: number;
  b: number;
let test1: Test1 = {
  a: 1,
  b: 2,
  c: "3",
let test2: Test2 = {