关于typescript:TypeScript-随想-实际应用与技巧

目录

• 类型元编程
• 内置工具类型窥探
• 内部工具类型举荐
• 新操作符
• 申明文件

类型元编程

什么是元编程：

维基百科是这样形容的：元编程是一种编程技术，编写进去的计算机程序可能将其余程序作为数据来解决。意味着能够编写出这样的程序：它可能读取、生成、剖析或者转换其它程序，甚至在运行时批改程序本身。在某些状况下，这使程序员能够最大限度地缩小表白解决方案的代码行数，从而缩小开发工夫。它还容许程序更灵便无效地解决新状况而无需从新编译。

简略的说，元编程可能写出这样的代码：

• 能够生成代码
• 能够在运行时批改语言构造，这种景象被称为反射编程（Reflective Metaprogramming）或反射（Reflection）

什么是反射：

反射是元编程的一个分支，反射又有三个子分支：

1. 自省（Introspection）：代码可能自我查看、拜访外部属性，咱们能够据此取得代码的底层信息。
2. 自我批改（Self-Modification）：顾名思义，代码能够批改本身。
3. 调解（Intercession）：字面意思是「代别人行事」，在元编程中，调解的概念相似于包装（wrapping）、捕捉（trapping）、拦挡（intercepting）。

举个理论一点的例子

• ES6（ECMAScript 2015）中用 Reflect（实现自省）和 Proxy（实现调解）进行编码操作，称之为是一种元编程。
• ES6 之前利用 eval 生成额定的代码，利用 Object.defineProperty 扭转某个对象的语义等。

TypeScript 的类型元编程

个人感觉「元编程」这个概念并没有规范的明确的定义，所以本文这里就把在 TypeScript 中应用 infer、keyof、in 等关键字进行操作，称之为是 TypeScript 的类型元编程。或者说是「偏底层一点的个性」或者「骚操作」，大家明确其用处即可。

unknown

unknown type 是 TypeScript 中的 Top Type。符号是 (⊤), 换句话说，就是任何类型都是 unknown 的子类型，unknown 是所有类型的父类型。换句最简略的话说，就是 任何值都能够赋值给类型是 unkown 的变量，与其对应的是，咱们不能把一个 unkown 类型的值赋值给任意非 unkown 类型的值。

let a: unknown = undefined
a = Symbol('deep dark fantasy')
a = {}
a = false
a = '114514'
a = 1919n

let b : bigint = a; // Type 'unknown' is not assignable to type 'bigint'.

never

never 的行为与 unknown 相同，never 是 TypeScript 中的 Bottom Type，符号是 (⊥)，换句话说，就是任何类型都是 never 的父类型，never 是所有类型的子类型。

也能够顾名思义，就是「永远不会」=>「不要」的意思，never 与 infer 联合是常见体操姿态，下文会介绍。

let a: never = undefined // Type 'undefined' is not assignable to type 'never'

keyof

能够用于获取对象或数组等类型的所有键，并返回一个联结类型

interface Person {
  name: string
  age: number
}

type K1 = keyof Person  // "name" | "age"

type K2 = keyof []      // "length" | "toString" | "push" | "concat" | "join"

type K3 = keyof {[x: string]: Person }  // string | number

in

在映射类型中，能够对联结类型进行遍历

type Keys = 'firstName' | 'lastName'

type Person = {[key in Keys]: string
}

// Person: {firstName: string; lastName: string;}

[]

索引操作符，应用 [] 操作符能够进行索引拜访，所谓索引，就是依据肯定的指向返回相应的值，比方数组的索引就是下标 0, 1, 2 等。TypeScript 里的索引签名有两种：字符串索引和数字索引。

字符串索引（对象）

对于纯对象类型，应用字符串索引，语法：T[key]

interface Person {
  name: string
  age: number
}

type Name = Person['name']  // Name: string

索引类型自身也是一种类型，因而还能够应用联结类型或者其余类型进行操作

type I1 = Person['name' | 'age']  // I1: string | number

type I2 = Person[keyof Person]    // I2: string | number

数字索引（数组）

对于类数组类型，应用数字索引，语法：T[number]

type MyArray = ['Alice', 'Bob', 'Eve']

type Alice = MyArray[0]       // 'Alice'

type Names = MyArray[number]  // 'Alice' | 'Bob' | 'Eve'

理论一点的例子

const PLAYS = [
  {
    value: 'DEFAULT',
    name: '领取送',
    desc: '用户领取后即获赠一张券',
  },
  {
    value: 'DELIVERY_FULL_AMOUNT',
    name: '满额送',
    desc: '用户领取满肯定金额可获赠一张券',
    checkPermission: true,
    permissionName: 'fullAmount',
  },
]

type Play = typeof PLAYS[number]

/*
type Play = {
    value: string;
    name: string;
    desc: string;
    checkPermission?: undefined;
    permissionName?: undefined;
} | {
    value: string;
    name: string;
    desc: string;
    checkPermission: boolean;
    permissionName: string;
}
*/

泛型（generic）

软件工程中，咱们不仅要创立统一的定义良好的 API，同时也要思考可重用性。组件不仅可能反对以后的数据类型，同时也能反对将来的数据类型，这在创立大型零碎时十分有用。

理论例子，封装 ajax 申请库，反对不同的接口返回它该有的数据结构。

function ajax<T>(options: AjaxOptions): Promise<T> {// actual logic...}

function queryAgencyRole() {return ajax<{ isAgencyRole: boolean}>({
    method: 'GET',
    url: '/activity/isAgencyRole.json',
  })
}

function queryActivityDetail() {return ajax<{ brandName: string;}>({
    method: 'GET',
    url: '/activity/activityDetail.json',
  })
}

const r1 = await queryAgencyRole()

r1.isAgencyRole  // r1 里能够拿到 isAgencyRole

const r2 = await queryActivityDetail()

r2.brandName     // r2 里能够拿到 brandName

extends

在官网的定义中称为条件类型（Conditional Types），能够了解为「三目运算」，T extends U ? X : Y，如果 T 是 U 的子集，那么就返回 X 否则就返回 Y。

• 个别与泛型配合应用。
• extends 会遍历联结类型，返回的也是联结类型。

type OnlyNumber<T> = T extends number ? T : never

type N = OnlyNumber<1 | 2 | true | 'a' | 'b'>  // 1 | 2

通常状况下，散布的联结类型是咱们想要的，然而也能够让 extends 不遍历联结类型，而作为一个整体进行判断与返回。只须要在 extends 关键字的左右两侧加上方括号 [] 进行润饰即可。

// 散布的条件类型
type ToArray<T> = T extends any ? T[] : never;

type R = ToArray<string | number>;

// type R = string[] | number[]

// 不散布的条件类型
type ToArrayNonDist<T> = [T] extends [any] ? T[] : never;

type R = ToArrayNonDist<string | number>;

// type R = (string | number)[]

infer

infer 关键字能够对运算过程中的类型进行存储，相似于定义一个变量。
内置的工具类型 ReturnType 就是基于此个性实现的。

type ReturnType<T> = T extends (...args: any) => infer R ? R : any;

type R1 = ReturnType<() => number>     // R1: number
type R2 = ReturnType<() => boolean[]>  // R2: boolean[]

递归（recursion）

在 TypeScript 中递归也是调用（或援用）本人，不过不肯定须要跳出。
如下，定义 JSON 对象的规范类型构造。

// 定义根底类型集
type Primitive = string | number | boolean | null | undefined | bigint | symbol

// 定义 JSON 值
type JSONValue = Primitive | JSONObject | JSONArray

// 定义以纯对象开始的 JSON 类型
interface JSONObject {[key: string]: JSONValue
}

// 定义以数组开始的 JSON 类型
type JSONArray = Array<JSONValue>

提个小问题：为什么 TypeScript 不跳出递归也不会陷入死循环？

But apart from being computationally intensive, these types can hit an internal recursion depth limit on sufficiently-complex inputs. When that recursion limit is hit, that results in a compile-time error. In general, it’s better not to use these types at all than to write something that fails on more realistic examples.
–from https://www.typescriptlang.or…

typeof

概念：像 TypeScript 这样的古代动态类型语言，个别具备两个搁置语言实体的「空间」，即类型空间（type-level space）和值空间（value-level space），前者用于寄存代码中的类型信息，在运行时会被齐全擦除掉；后者用于寄存代码中的「值」，会保留到运行时。

• 值空间：变量、对象、数组、class、enum 等。
• 类型空间：type、interface、class、enum 等。

typeof 的作用是把「值空间」的数据转换成「类型空间」的数据。

const MARKETING_TYPE = {
  ISV: 'ISV_FOR_MERCHANT',
  ISV_SELF: 'ISV_SELF',
  MERCHANT: 'MERCHANT_SELF',
}

type MarketingType = typeof MARKETING_TYPE

/*
type MarketingType = {
  ISV: string;
  ISV_SELF: string;
  MERCHANT: string;
}
*/

as const

as const 是一个类型断言，作用也是把「值空间」的数据转换成「类型空间」的数据，并且设置成只读。

let x = 'hello' as const;   // x: 'hello'

let y = [10, 20] as const;  // y: readonly [10, 20]

let z = {text: 'hello'} as const;  // z: {readonly text: 'hello'}

理论一点的例子：

const MARKETING_TYPE = {
  ISV: 'ISV_FOR_MERCHANT',
  ISV_SELF: 'ISV_SELF',
  MERCHANT: 'MERCHANT_SELF',
} as const

type MT = typeof MARKETING_TYPE

type MarketingType = MT[keyof MT]

/*
type MT = {
  readonly ISV: "ISV_FOR_MERCHANT";
  readonly ISV_SELF: "ISV_SELF";
  readonly MERCHANT: "MERCHANT_SELF";
}

type MarketingType = "ISV_FOR_MERCHANT" | "ISV_SELF" | "MERCHANT_SELF"
*/

内置工具类型窥探

TypeScript 内置了一些实用的工具类型，能够进步开发过程中类型转换的效率。
基于下面的理解，再来浏览内置工具类型就很轻松了，这里咱们就列举几个罕用或者有代表性的工具类型。

Partial

作用：把对象的每个属性都变成可选属性。

interface Todo {
  title: string;
  description: string;
}

type NewTodo = Partial<Todo>

/*
type NewTodo = {
  title?: string;
  description?: string;
}
*/

原理：把每个属性增加 ? 符号，使其变成可选属性。

type Partial<T> = {[P in keyof T]?: T[P];
};

Required

作用：与 Partial 相同，把对象的每个属性都变成必填属性。

interface Todo {
  title?: string;
  description?: string;
}

type NewTodo = Required<Todo>

/*
type NewTodo = {
  title: string;
  description: string;
}
*/

原理：给每个属性增加 -? 符号，- 指的是去除，-? 意思就是去除可选，就变成了 required 类型。

type Required<T> = {[P in keyof T]-?: T[P];
};

Readonly

作用：把对象的每个属性都变成只读属性。

interface Todo {
  title: string;
  description: string;
}

type NewTodo = Readonly<Todo>

/*
type NewTodo = {
  readonly title: string;
  readonly description: string;
}
*/

const todo: Readonly<Todo> = {title: 'Delete inactive users'}

// Cannot assign to 'title' because it is a read-only property.
todo.title = "Hello";

原理：给每个属性增加 readonly 关键字，就变成了只读属性。

type Readonly<T> = {readonly [P in keyof T]: T[P];
};

Pick

作用：与 lodash 的 pick 办法一样，筛选对象里须要的键值返回新的对象，不过这里筛选的是类型。

interface Todo {
  title: string;
  description: string;
  completed: boolean;
}
 
type TodoPreview = Pick<Todo, 'title' | 'completed'>

/*
type TodoPreview = {
  title: string;
  completed: boolean;
}
*/

原理：应用条件类型束缚传入的联结类型 K，而后再对符合条件的联结类型 K 进行遍历。

type Pick<T, K extends keyof T> = {[P in K]: T[P];
};

Omit

作用：与 Pick 工具办法相同，排除对象的某些键值。

interface Todo {
  title: string;
  description: string;
  completed: boolean;
}
 
type TodoPreview = Omit<Todo, 'description'>

/*
type TodoPreview = {
  title: string;
  completed: boolean;
}
*/

原理：与 Pick 相似，不过是先通过 Exclude 失去排除后的残余属性，再遍历生成新对象类型。

type Omit<T, K extends keyof any> = Pick<T, Exclude<keyof T, K>>;

Exclude

作用：排除联结类型里的一些成员类型。

type T0 = Exclude<'a' | 'b' | 'c', 'a'>        // T0: 'b' | 'c'

type T1 = Exclude<'a' | 'b' | 'c', 'a' | 'b'>  // T1: 'c'

原理：通过条件类型 extends 把不须要的类型排除掉。

type Exclude<T, U> = T extends U ? never : T;

Parameters

作用：获取函数的参数类型，返回的是一个元组类型

type T0 = Parameters<() => string>         // T0: []
type T1 = Parameters<(s: string) => void>  // T1: [s: string]

原理：通过 infer 关键字获取函数的参数类型并返回

type Parameters<T extends (...args: any) => any> = 
  T extends (...args: infer P) => any ? P : never;

ReturnType

作用：获取函数的返回类型

type R1 = ReturnType<() => number>      // R1: number
type R2 = ReturnType<() => boolean[]>   // R2: boolean[]

原理：通过 infer 关键字获取函数返回类型

type ReturnType<T extends (...args: any) => any> = 
  T extends (...args: any) => infer R ? R : any;

Awaited

作用：获得无 Promise 包裹的原始类型。

type res = Promise<{brandName: string}>

type R = Awaited<res>  // R: {brandName: string}

原理：如果是一般类型就返回该类型，如果是 Promise 类型，就用 infer 定义 then 的值，并返回。

type Awaited<T> =
  T extends null | undefined
    ? T
    : T extends object & {then(onfulfilled: infer F): any } // 查看 Promise 类型
      ? F extends (value: infer V, ...args: any) => any 
        ? Awaited<V>  // 递归 value 类型
        : never       // 不合乎规定的 Promise 类型抛弃
      : T;    // 不是 Promise 类型间接返回 

Promise 类型形态如下

/**
 * Represents the completion of an asynchronous operation
 */
interface Promise<T> {
    /**
     * Attaches callbacks for the resolution and/or rejection of the Promise.
     * @param onfulfilled The callback to execute when the Promise is resolved.
     * @param onrejected The callback to execute when the Promise is rejected.
     * @returns A Promise for the completion of which ever callback is executed.
     */
    then<TResult1 = T, TResult2 = never>(onfulfilled?: ((value: T) => TResult1 | PromiseLike<TResult1>) | undefined | null, onrejected?: ((reason: any) => TResult2 | PromiseLike<TResult2>) | undefined | null): Promise<TResult1 | TResult2>;

    /**
     * Attaches a callback for only the rejection of the Promise.
     * @param onrejected The callback to execute when the Promise is rejected.
     * @returns A Promise for the completion of the callback.
     */
    catch<TResult = never>(onrejected?: ((reason: any) => TResult | PromiseLike<TResult>) | undefined | null): Promise<T | TResult>;
}

获取 Promise 类型的另一种简略实现：

type Awaited<T> = T extends PromiseLike<infer U> ? Awaited<U> : T

内部工具类型举荐

市面上有 2 款 star 比拟多的开源工具库
type-fest: https://github.com/sindresorh…
utility-types: https://github.com/piotrwitek…
type-fest 没有用过，介绍一下 utility-types 的 ValuesType，比拟罕用。

ValuesType

获取对象或数组的值类型。

interface Person {
  name: string
  age: number
}

const array = [0, 8, 3] as const

type R1 = ValuesType<Person>          // string | number
type R2 = ValuesType<typeof array>    // 0 | 8 | 3
type R3 = ValuesType<[8, 7, 6]>       // 8 | 7 | 6

理论例子：获取 JS 常量的值类型，防止重复劳动。

const MARKETING_TYPE = {
  ISV: 'ISV_FOR_MERCHANT',
  ISV_SELF: 'ISV_SELF',
  MERCHANT: 'MERCHANT_SELF',
} as const

type MarketingType = ValuesType<typeof MARKETING_TYPE>

// type MarketingType = "ISV_FOR_MERCHANT" | "ISV_SELF" | "MERCHANT_SELF"

实现原理：应用上文说到的「字符串索引」和「数字索引」来取值。

type ValuesType<
  T extends ReadonlyArray<any> | ArrayLike<any> | Record<any, any>
> = T extends ReadonlyArray<any>
  ? T[number]
  : T extends ArrayLike<any>
  ? T[number]
  : T extends object
  ? T[keyof T]
  : never;

新操作符

[2.0] Non-null assertion operator（非空断言符）

断言某个值存在

function createGoods(value: number): {type: string} | undefined {if (value < 5) {return}
  return {type: 'apple'}
}

const goods = createGoods(10)

goods.type  // ERROR: Object is possibly 'undefined'. (2532)

goods!.type  // ✅

[3.7] Optional Chaining（可选链操作符）

可选链操作符能够跳过值为 null 和 undefined 的状况，只在值存在的状况下才会执行前面的表达式。

let x = foo?.bar()

编译后的后果如下：

let x = foo === null || foo === void 0 ? void 0 : foo.bar();

理论场景的比照：

// before
if (user && user.address) {// ...}

// after
if (user?.address) {// ...}

// 语法：obj.val?.prop     // 属性拜访
obj.val?.[expr]   // 属性拜访
obj.arr?.[index]  // 数组拜访
obj.func?.(args)  // 函数调用 

[3.7] Nullish Coalescing（双问号操作符）

// before
const isBlack = params.isBlack || true   // ❌
const isBlack = params.hasOwnProperty('isBlack') ? params.isBlack : true  // ✅

// after
const isBlack = params.isBlack ?? true  // ✅

[4.0] Short-Circuiting Assignment Operators（复合赋值操作符）

在 JavaScript 和许多程序语言中，称之为 Compound Assignment Operators（复合赋值操作符）

// Addition
// a = a + b
a += b;

// Subtraction
// a = a - b
a -= b;

// Multiplication
// a = a * b
a *= b;

// Division
// a = a / b
a /= b;

// Exponentiation
// a = a ** b
a **= b;

// Left Bit Shift
// a = a << b
a <<= b;

新增：

a &&= b   // a && (a = b)
a ||= b   // a || (a = b)
a ??= b   // a ?? (a = b)

示例：

let values: string[];

// Before
(values ?? (values = [])).push("hello");

// After
(values ??= []).push("hello");

申明文件

通常了解就是 .d.ts 文件，按性能能够分为：变量申明、模块申明、全局类型申明、三斜线指令等。

变量申明

如果咱们想应用第三方库 jQuery，一种常见的形式是在 html 中通过 <script> 标签引入 jQuery，而后就能够应用全局变量 $ 或 jQuery 了。假如要获取一个 id 为 foo 的元素。

jQuery('#foo')  // ERROR: Cannot find name 'jQuery'.

TS 会报错，因为编译器不晓得 $ 或 jQuery 是什么，所以须要申明这个全局变量让 TS 晓得，通过 declare var 或 declare let/const 来申明它的类型。

// 申明变量 jQuery
declare var jQuery: (selector: string) => any;

// let 和 var 没有区别，更倡议应用 let
declare let jQuery: (selector: string) => any;

// const 申明的变量不容许被批改
declare const jQuery: (selector: string) => any;

申明函数

// 申明函数
declare function greet(message: string): void;

// 应用
greet('hello')

申明类

// 申明类
declare class Animal {
  name: string;
  constructor(name: string);
  sayHi(): string;}

// 应用
const piggy = new Animal('佩奇')
piggy.sayHi()

申明对象

// 申明对象
declare const jQuery: {
  version: string
  ajax: (url: string, settings?: any) => void
}

// 应用
console.log(jQuery.version)
jQuery.ajax('xxx')

还能够应用 namespace 命名空间来申明对象，晚期 namespace 的呈现是为了解决模块化而发明的关键字，随着 ES6 module 关键字的呈现，为了防止性能混同，当初倡议不应用。

declare namespace jQuery {
  const version: string
  function ajax(url: string, settings?: any): void;
}

模块申明

通常咱们引入 npm 包，它的申明文件可能来源于两个中央：

• 包内置的类型文件，package.json 的 types 入口。
• 装置 @types/xxx 对应的包类型文件。

如果下面两种形式都没有找到对应的申明文件，那么就须要手动为它写申明文件了，通过 declare module 来申明模块。

实例：手动修复 @alipay/h5data 的类型反对。

interface H5DataOption {
  env: 'dev' | 'test' | 'pre' | 'prod';
  autoCache: boolean;
}

declare module '@alipay/h5data' {
  export function fetchData<T extends any>(
    path: string,
    option?: Partial<H5DataOption>,
  ): Promise<T>;
}

// 应用
import {fetchData} from '@alipay/h5data'

const res = await fetchData<{data: 'xxx'}>('url/xxx')

拓展模块类型

某些状况下，模块曾经有类型申明文件了，但引入了一些插件，插件没有反对类型，这时就须要扩大模块的类型。还是通过 declare module 扩大，因为模块申明的类型会合并。

declare module 'moment' {export function foo(): string
}

// 应用
import moment from 'moment'
import 'moment-plugin'

moment.foo()

全局类型申明

类型的作用域

在 Typescript 中，只有文件存在 import 或 export 关键字，都被视为模块文件。也就是不论 .ts 文件还是 .d.ts 文件，如果存在上述关键字之一，则类型的作用域为以后文件；如果不存在上述关键字，文件内的变量、函数、枚举等类型都是以全局作用域存在于我的项目中的。

全局作用域申明全局类型

全局作用域内申明的类型皆为全局类型。

部分作用域申明全局类型

部分作用域内能够通过 declare global 申明全局类型。

import type {MarketingType} from '@/constants'

declare global {
  interface PageProps {
    layoutProps: {
      marketingType: MarketingType;
      isAgencyRole: boolean;
    };
  }
}

三斜线指令

三斜线指令必须放在文件的最顶端，三斜线指令的后面只容许呈现单行或多行正文。
三斜线指令的作用是为了形容模块之间的依赖关系，通常状况下并不会用到，不过在以下场景，还是比拟有用。

• 当在书写一个依赖其余类型的全局类型申明文件时
• 当须要依赖一个全局变量的申明文件时
• 当解决编译后 .d.ts 文件失落的问题

当须要书写一个依赖其余类型的全局类型申明文件时

在全局变量的申明文件中，是不容许呈现 import, export 关键字的，一旦呈现了，那么以后的申明文件就不再是全局类型的申明文件了，所以这时就须要用到三斜线指令。

/// <reference types="jquery" />

declare function foo(options: JQuery.AjaxSettings): string;

依赖一个全局变量的申明文件

当须要依赖一个全局变量的申明文件时，因为全局变量不反对通过 import 导入，所以就须要应用三斜线指令来引入了。

/// <reference types="node" />

export function foo(p: NodeJS.Process): string;

当解决编译后 .d.ts 文件失落的问题

在写我的项目的时候，我的项目里编写的 .d.ts 文件在 tsc 编译后，并不会搁置到对应的 dist 目录下，这时候就须要手动指定依赖的全局类型。

/// <reference path="types/global.d.ts" />

// ValueOf 来自 global.d.ts
export declare type ComplexOptions = ValueOf<typeof complexOptions>;

reference

• path: 指定类型文件的门路
• types: 指定类型文件对应的包，例如 对应的类型文件是

参考

TypeScript Handbook：https://www.typescriptlang.or…
TypeScript Learning: https://github.com/Barrior/ty…
你不晓得的 TypeScript 高级技巧：https://www.infoq.cn/article/…
TypeScript 入门教程：https://ts.xcatliu.com/basics…
读懂类型体操：TypeScript 类型元编程根底入门：https://zhuanlan.zhihu.com/p/…
JavaScript 元编程：https://chinese.freecodecamp….
其余材料