快速上手typescript（基础篇）

壹 ❀ 引

在javascript开发中，你可能也遇到过我这样的苦恼，在维护某段几年前的老旧代码时，我发现了某个数据加工方法fn，而且根据现有逻辑来看fn的某个参数是一个数组，因为新需求我需要对数组做一次过滤，于是我在代码中补了一段params.filter类似的代码，测试没问题顺利上线，然后第二天客户反馈页面白屏直接功能直接炸了，打开控制台一看，不能从undefined上读取数组方法filter，这个参数在某个不为人知的场景下根本就没传递，整个人就大无语。

const fn = (a, b) => {
  const b_ = b.filter();
}

你会发现在某些场景下，我们根本无法得知某个变量是不是一定就是这个类型，某个变量是不是一定会按你预期进行传递。那有没有什么办法在我们书写代码时就能提前检测，而不是只有代码跑起来才能感知呢（让客户做测试都会死的很明白）？这时候我们就需要typescript了。

与传统动态弱类型语言javascript不同，静态类型的typescript在执行前会先编译成javascript，因为它强大的type类型系统加持，能让我们在编写代码时增加更多严谨的限制。注意，它并不是一门全新的语言，所以并没有增加额外的学习成本，你甚至可以将它理解为新增了类型封装的javascript，因此原先代码逻辑怎么写现在还是一样的写，至于底层编译的事我们无需关心。

本文将作为typescript的基础篇，当然本质上也是我自己的知识梳理笔记，本文中所有例子都可以在typescript练习上在线编辑，方便某些还不想在项目中安装typescript的同学，那么本文开始。

贰 ❀ 原始数据类型

typescript与js一样也有原始数据类型与对象数据类型，我们先来介绍常用的原始数据类型。

贰 ❀ 壹 string

let str: string = '听风是风';
// 支持模板字符串
const echo = '听风是风';
let s: string = `name is ${echo}`;

贰 ❀ 贰 number

let num: number = 1;
let notANumber: number = NaN;

贰 ❀ 叁 boolean

let bool: boolean = true;

贰 ❀ 肆 任意类型any

any用于表示任意类型，如果一个变量的类型为any，那么它可以被赋予任意类型的值，你可能会觉得any应该没啥使用场景，但恰恰相反的是，在日常赶项目赶交付期间，研发同学可能没有太多时间去做细致化类型定义，于是any走天下，这也是typescript又被戏称为anyscript的原因。

let a: any = 4;
a = "4";
a = false;

这一点也能证明typescript所有类型都属于any的子类型。

贰 ❀ 伍 undefined与null

let a: undefined = undefiend;
let b: null = null;

默认情况下undefined与null这两个类型属于所有类型的子类型，也就是说你能将一个undefined复制给一个number的变量，但是开发中一般不推荐这么做，既然我们希望typescript为我们添加严格的类型判断，那么严格尊重总是有好处，你肯定也希望某种情况下undefiened调用了某个number的API。

我们可以在tsconfig配置中添加strictNullChecks:true的开关，来启用严格的控制判断，这样undefined或者null就只能赋值给它们自身类型的变量，虽然这两个类型本身用的也不多。

贰 ❀ 陆 空 void

void与any相反，它表示没有任意类型，比如一个函数需要返回一个字符串，你可以定义函数返回值的类型：

const fn =  (): string => {
    return '1';
}

但假设这个函数没有返回值，那么就可以用void：

const fn =  (): void => {
    console.log(1);
}

但事实上开发中如果一个函数无返回，我们也不会写void，因为本身也没什么意义，所以void使用并不多。

另外即使打开了strictNullChecks开关，我们还是能将undefined与null赋予给void类型的变量，即使这也没啥意义= =。

叁 ❀ 数组类型

array定义支持两种写法，一种是类型[]，另一种是Array<类型>，比如：

// 元素全是number类型的数组
let arr1: number[] = [1, 2, 3];
// 元素全是string类型的数组
let arr2: Array<string> = ['1', '2', '3'];

number[]就表示这个数组的所有元素都必须是数字，包括之后你也不能往数组中添加非数字的元素，比如：

let arr: number[] = [1, 2, 3];
arr.push('听风是风');// error 听风是风不是number类型

那假设数组元素种类比较多，我们可以用any来表示数组中可以出现任意类型，比如：

let arr: any[] = [1, 2, '3'];
arr.push(undefined);

肆 ❀ 接口类型（对象类型）

我们一般用接口interface来描述对象类型（这里的对象指{}），比如人都有名字，性别年龄等属性，接口即可用于对人这个类的形状进行抽象描述，直接看个例子：

// 我们定义了一个叫Person的接口，推荐首字母大写
interface Person {
    name: string;
    age: number;
}

let echo: Person = {
    name: '听风是风',
    age: 28,
}

我们定义了一个接口Person，然后变量echo使用了接口Person，可以看到echo和Person的属性形状需要保持一致，缺属性或者多属性都不行：

// 少属性
// error Property 'age' is missing in type '{ name: string; }'.
let echo: Person = {
    name: '听风是风',
}
// 多属性
let echo: Person = {
    name: '听风是风',
    age: 28,
    gender: 'male'// Person上未指定gender:string
}

肆 ❀ 壹 可选属性

接口支持使用?让某个属性变为可选，女性的年龄都是秘密，某种场景下我们并不能拿到age属性，那么我们可以让Person的age为可选，比如：

interface Person {
    name: string;
    age?: number;
}

// 缺少了age属性，但并不会报错
let echo: Person = {
    name: '西西',
}

肆 ❀ 贰 只读属性

除了限定属性可选，我们还可以通过readonly字段来限制某个属性只读，比如：

interface Person {
    readonly name: string;
    age: number;
}

let echo: Person = {
    name: '听风是风',
    age: 28,
}
echo.name = '时间跳跃';// error 无法修改只读属性

可以看到name添加了只读，因此它在初始化之后就无法修改。

肆 ❀ 叁 限制接口属性范围

比如上述代码我们限制了名称是字符串，也就是说任意字符串都可以，假设我们设计了一个组件，它的名称属性将决定组件如何展示，而且我们预定了只支持两种模式，那么此时我们就可以更精确的来限制属性范围，比如：

interface P {
    name: 'wide'| 'narrow';
}

let props:P = {
  name: 'wide'
}

此时props的name字段只能是wide或者narrow其一，输入其它就会报错，这样能很好的让组件属性输入符合预期。

肆 ❀ 肆 额外的任意属性

某些情况我们希望接口能添加任意属性，那么可以通过如下方式：

interface Person {
    name: string;
    age?: number;
    [propName: string]: any;
}

let echo: Person = {
    name: '听风是风',
    age: 28,
    hobby: '吃西瓜',
    gender: 'male'
}

[propName: string]: any表示可以添加变量名为string且值为any类型，propName的类型只会限制额外的属性，假设我们将其改为[propName: number]，那么hobby与gender就会报错，而我们将其变量名改为数字则不会有问题：

interface Person {
    name: string;
    age?: number;
    [propName: number]: any;
}

let echo: Person = {
    name: '听风是风',
    age: 28,
    1: '吃西瓜',
    2: 'male'
}

但重点需要注意的是，假设我们定了额外的属性，那么确定属性以及可选属性的类型一定得是额外属性的子类型，比如上面string和number都是any的子类型，假设我们将any改为string，那么age属性就会报错：

interface Person {
    name: string;
    // 类型“number”的属性“age”不能赋给字符串索引类型“string”
    age?: number;
    [propName: string]: string;
}

let echo: Person = {
    name: '听风是风',
    age: 28,
    hobby: '吃西瓜',
    gender: 'male'
}

假设我们不想定义any来包含string与number，这里也可以使用联合类型string | number来取代any：

interface Person {
    name: string;
    age?: number;
    [propName: string]: string | number;
}

let echo: Person = {
    name: '听风是风',
    age: 28,
    hobby: '吃西瓜',
    gender: 'male'
}

伍 ❀ 函数类型

javascript中创建函数常用有函数声明与函数表达式两种形式，由于函数有输入和输出，所以我们需要对参数以及返回结果都做限制，我们来分别介绍两种写法。

伍 ❀ 壹 函数声明

function sum(x: number, y: number): number {
    return x + y;
};

比如上述的sum函数就接受2个类型为数字的变量x,y，并会返回它们的和，和的类型也是数字。

在限制下我们调用函数时少传多传，或者传递的参数类型不对都会有错误提示：

sum(1,'2');// error '2'的不是数字类型
sum(1);// error 需要2个参数但只传递了1个
sum(1,2,3)// error 需要2个参数但传递了3个

伍 ❀ 贰 函数表达式

我们将上面的代码改为函数表达式可以是这样：

let sum = function (x: number, y: number): number {
    return x + y;
};

但其实这种写法是省略了sum类型的写法，让typescript自己进行了类型推断，啥意思呢？我们将鼠标放到sum上你就能看到sum自身的类型限制：

意思就是，我们将一个匿名函数赋值给了sum，匿名函数虽然做了参数以及返回值的类型限定，但是我们没对变量sum做类型限定，sum是什么类型？很显然是函数类型，所以完整的写法应该是这样：

let sum: (x: number, y: number) => number = function (x: number, y: number): number {
  return x + y;
};

注意(x: number, y: number) => number这一段是对于sum这个变量类型的描述，表示它是一个函数类型，接受了哪些参数，分别是什么类型，以及返回什么类型。正常我们在接口中描述对象某个属性是一个函数也是相同的写法，比如：

interface Person {
    name: string;
    age: number;
    canFly: () => boolean
};

let echo: Person = {
    name: '听风是风',
    age: 28,
    canFly: function () { return false }
}

在接口中我们对canFly进行了描述，它是一个函数类型，没有入参且返回一个布尔值，于是在变量echo中我们具体实现了这个方法，同样没有入参，直接返回一个布尔值。这就相当于函数类型说明都被提到接口中统一描述了，而到具体实现时你不用重复再限制一次。而在上面的函数表达式中，我们要么省略变量的限制让typescript自行推断，要么我们手动补全变量的函数类型限制，其实就是这个意思。

当然，如果你觉得自己补全看着函数太长了，我们也能将函数变量这一块的描述交给接口，这样看着就相对简洁一点：

// 将函数变量的约束抽离出来给接口来做
interface MySum {
    (x: number, y: number): number
}

let sum: MySum = function (x: number, y: number): number {
    return x + y;
};

伍 ❀ 叁 可选参数

函数同样支持使用?来表示某个参数可选：

function sum(x: number, y?: number): number {
    return x + y;
};

sum(1);

伍 ❀ 肆 参数默认值

有默认值的参数在typescript中会被默认识别为可选参数，毕竟有默认值传不传递都可以：

function sum(x: number, y: number = 1): number {
    return x + y;
};

sum(1);

伍 ❀ 伍 ...rest参数

在es6中我们可以用...rest来表示函数剩余参数，这也巧妙解决了arguments是类数组无法使用数组api的问题，因为在函数内rest就是一个数组，因此我们可以用数组类型来描述rest，比如：

function fn(a: number, ...rest: any[]) {
    rest.forEach((item) => console.log(item))
}
fn(1, 2, 3, 4, 5);

陆 ❀ 联合类型

很多时候，我们可能需要让一个变量支持数字以及字符串等多种类型，这时候就需要使用联合类型，它使用符号|表示，比如：

// echo的值可以是数字或者字符串
let echo: number | string = 'echo';
echo = 1;

以上代码中的echo可以被赋值为任意的字符串或数字类型的值。但需要注意的是，当我们未给echo赋予准确的值，但需要访问某个属性或api，此时只能访问联合类型共有的属性或者方法，比如：

let echo: number | string;
// 数字和字符串都支持toString方法
echo.toString();
// 报错，Property 'toFixed' does not exist on type 'string'.
echo.toFixed(1);

但假设我们给echo赋予具体的值，此时联合类型同样会走类型推断，从而让我们能正确使用对应类型的api，比如：

let echo: number | string;
// 此时被推断成字符串，因此能调用字符串的api
echo = '听风是风';
echo.length;// 4

// 此时被推断成数字，因此能调用数字的api
echo = 1.021;
echo.toFixed(2); // '1.02'

柒 ❀ 类型推断

首先类型推断属于typescript的一个概念，相当于typescript底层自动会帮我们做的一件事，大家作为了解就好。

正常来说我们定义字符串是这样，我们明确标明了str的类型，以及符合预期的修改str的值：

let str: string = 'echo';
str = '听风是风';

但假设我们不去定义一个变量的类型，但赋予了这个变量一个明确的值，比如一个字符串，再修改值为数字时，你会发现报错了：

let str = 'echo';
str = 1; //Type '1' is not assignable to type 'string'.

这是因为typescript会根据我们最初赋予的值，尝试去推断这个变量的类型，所以即便我们没指定具体类型，后续也不能随意修改值的类型，这就是所谓的类型推断了。

上述代码等价于：

let str: string = 'echo';
str = 1; //Type '1' is not assignable to type 'string'.

也就是说，只要你定义的文件是.ts，就别想着在ts文件不定义类型然后随意赋值，这对于ts而言肯定是不允许的。除了上文提到的几个不常用的类型，日常开发中我们还是希望能明确标明变量类型。

还有一种比较特殊，我指定以了一个变量但没赋值，这时候因为没具体的值，所以typescript会将这个变量推断成any类型，因此我们可以随意修改这个变量的值，比如：

let echo;
echo = '时间跳跃';
echo = 1;

// 等同于
let echo: any;
echo = '时间跳跃';
echo = 1;

捌 ❀ 类型断言

如果说类型推断是typescript自动做的类型判断，那么类型断言就是我们人为手动的来指定一个值的类型，它支持两种写法：

// <类型>变量名
<string>echo
// 变量名 as 类型
echo as string

需要注意的是，在tsx文件中只支持as这种写法，保险起见统一使用as更稳。

为什么会有类型断言的使用场景？我们来看几个例子你就明白了。

捌 ❀ 壹 联合类型断言场景

我们前面说了，当一个变量没具体赋值，且有联合类型时，它只能使用联合类型共有的属性或方法，那假设我们现在封装了一个方法:

function fn(s: string | number): number {
    // 报错 Property 'length' does not exist on type 'number'.
    return s.length;
};

我们假定参数s可能是字符串或者数字两种类型，但是你很清楚这个方法只会接受到字符串，那我们就可以手动指定s的类型，比如：

function fn(s: string | number): number {
    return (s as string).length;
};

类型断言的目的就是我们开发者主动的告诉typescipt，我现在很清楚这个变量此时的类型是什么，从而让typescript不报错，但上述编码编译成js后其实也只是一个普通的返回s.length的函数，假设参数依旧传递了一个数字进来，那么还是无法避免报错的尴尬，所以使用类型断言时一定得谨慎，它只是绕过typescirpt报错，并没有从根源上解决代码兼容问题。

上述代码通过if来限制执行，你会发现这样实现其实更稳：

function fn(s: string | number): number {
    let length = 0;
    // 我们添加了判断，也相当于了人为对类型做了判断，因此也不会报错
    if (typeof s === 'string') {
        length = s.length;
    };
    return length;
};

捌 ❀ 贰 父子类断言场景

ES6支持类的定义与继承，而当类具有继承关系时，类型断言也会起到作用，比如：

class P { }

class P1 extends P {
    a: number = 1;
}
class P2 extends P {
    b: number = 2;
}

const fn = (s: P): boolean => {
    // 报错 Property 'a' does not exist on type 'P'.
    if (typeof s.a === 'number') {
        return true;
    }
    return false;
}

这里我们定义了一个父类P，基于P继承得到了P1 P2两个类，且两个类都有属于自己的实例属性，现在我们定义了一个比较通用的检测P类属性的方法，考虑到公用型，所以类型定义我们使用P，但在内部实现中，typescript会告诉你P上并没有属性a。这时候我们同样可以利用断言将类型精确到子类P1，如下：

const fn = (s: P): boolean => {
    if (typeof (s as P1).a === 'number') {
        return true;
    }
    return false;
}

当然这也只是绕过了typescript的检测，假设我们传递了一个P2实例进来，你会发现代码会报错，这并没有解决根本问题。所以更好的做法还是从逻辑层间提升代码稳定性，比如：

const fn = (s: P): boolean => {
    if (s instanceof P1) {
        return true;
    }
    return false;
}

捌 ❀ 叁 将任意类型断言为any

javascript中存在很多原生对象，这些对象一开始就没被添加类型，比如我们希望在全局对象window上添加属性就会报错：

window.echo = 1;// error window上不存在echo的类型

这时候我们可以手动将window断言为any以解决修改属性以及添加属性的问题：

(window as any).echo = 1;

我们知道window上默认自带一些属性，比如name字段默认是一个空字符，因此在typescript中name也默认被推断成了string类型，比如我们想将window.name修改为数字默认会报错：

window.name = 1;// error 不能将1赋予给字符串类型的name

而断言成any可以让我们任意修改window上的属性类型，这很方便但也有一定风险，在实际开发中请谨慎对待。

捌 ❀ 肆 将any断言成精确的类型

在旧有代码迁移ts或者维护不规范的ts代码时，我们可能会遇到因为赶项目赶时间而定义比较随意的any类型，而你了解了这段代码其实知道类型定义可以更为精确，重写重构代码写出完全规范的代码之外，你能通过断言对于模糊类型进行补救，比如：

interface UserInfo {
    name: string;
    age: number;
}

function getUserInfo(): any {
    return {
        name: '听风是风',
        age:28
    }
};

const user = getUserInfo() as UserInfo;

这样user后续的代码就能清楚知道这个对象是什么类型，对应让代码编写更严谨。

捌 ❀ 伍 类型断言的限制

断言虽然在某些场景很好用，但它也得满足一些断言场景，毕竟我们总不能将猫的类型断言成鱼的类型，这就不符合规范了。那么满足什么条件才能断言呢？先说结论，当类型A兼容了类型B，或者B兼容了A，那么A可以断言成B，B也能断言成A。

什么意思？我们在上文提到，所有的类型都是any的子类型，也就是说any兼容了其它所有类型，比如string类型，因此我们可以将any as string，也能将string as any，这都是可以的。

我们再来看个例子：

interface Person {
    name: string;
}
interface User {
    name: string;
    age: number;
}

let echo: User = {
    name: 'Tom',
    age: 28
};
// 注意，echo包含age，但Person类并没有age
let xixi: Person = echo;

我们定义了Person与User两个接口，比较有趣的事，我们将已定义了User类的变量echo赋值给xixi，而xixi的类Person并没有age属性，但并不会报错，而假设我们将代码改为如下这样，就会报错：

interface Person {
    name: string;
}
interface User {
    name: string;
    age: number;
}

let echo: User = {
    name: 'Tom',
    age: 28
};
let animal: Person = {
    name: 'Tom',
    age: 28 //error age在Person中未定义
};

为啥上面正常，下面这段代码就报错了，区别在哪？区别就在于上面的代码的echo提前定义好了User类型，而下面的赋值只是一个单纯的对象，是一个数据，它无类型。

那为什么上面不报错呢？其实说到底还是底层类型断言帮我们做了处理，上面的Person与User类型的关系你可以理解为：

interface Person {
    name: string;
}

// User继承了Person接口，并额外添加了age
interface User extends Person{
    age: number;
}

因此接口Person兼容了User（有相同属性，属性少的兼容属性多的）。还记得上文父子类断言场景中，我们将父类断言成子类的操作吗？你没发现参数处我们用了属性更少的父类P，但事实上传递进来的参数可能是接口P1或者P2的对象，它们的属性都比P接口定义的属性要多，但是参数这里并不会报错，而且在函数内我们还能将P断言为P1，本质原因也是P兼容了P1 P2。

其实总结上面聊到的几个使用场景：

• 联合类型string | number断言为string，两者存在兼容关系。
• 父类断言成子类场景，两者同样存在兼容关系。
• any断言成任意，任意类型断言成any，本质上也是兼容关系。

因此，只要两个类型存在兼容关系，不管谁兼容谁，都能相互断言成对方的类型。

另外，我们在前面说，猫类型不能断言成鱼类型，但现在你会发现一个很有趣的事情，猫类型和any是包含关系，而any和鱼类型同样是包含关系，那我能不能cat as any as fish双重断言直接实现跨物种进化呢？很明显通过这种做法，我们能实现类的任意断言，但typescript中一般不推荐这么做，因为大概率会导致类型错误....

捌 ❀ 伍 类型断言与类型声明

我们在将any断言成其它类型讲解中，为了完善类型定义模糊的代码，我们给了一个例子，其实它还有其它的修复方法，比如不全函数的返回值的类型：

interface UserInfo {
    name: string;
    age: number;
}

function getUserInfo(): UserInfo {
    return {
        name: '听风是风',
        age:28
    }
};

const user = getUserInfo();

除此之外，我们还能补全user的类型声明，达到相同的效果，比如：

interface UserInfo {
    name: string;
    age: number;
}

function getUserInfo(): any {
    return {
        name: '听风是风',
        age: 28
    }
};

const user: UserInfo = getUserInfo();

单看类型断言和类型声明的补全的，你会发现后续使用user完全一致，那这两者有啥区别吗？我们再来看个例子：

interface Person {
    name: string;
}
interface User {
    name: string;
    age: number;
}

let echo: Person = {
    name: '听风是风'
}
// echo类型是Person，没有age属性
let xixi = echo as User;
// xixi此时能使用age属性了
xixi.age = 27

上述代码很明显Person兼容了User，因此变量echo我们能使用断言将其类型由Person转为User后再赋值给xixi，之后xixi就能赋予age属性了。

但假设上述代码我们通过类型声明来做，如下，你会发现报错了：

interface Person {
    name: string;
}
interface User {
    name: string;
    age: number;
}

let echo: Person = {
    name: '听风是风'
}
// error Person缺少age属性
let xixi: User = echo;

为什么报错？很明显echo的Person类没有age属性，而User需要age属性，回到断言限制的第一个例子，对比下你会发现，我们将一个属性更多的类赋值给一个属性更少的类可以（后者兼容前者），反过来则会报错。

结合类型断言，你会发现类型声明的限制比类型断言要严格的多，大致我们可以总结为：

• 若A需要断言成B，只需要A兼容B或者B兼容A都可以
• 若将A赋值给B，那么一定是B兼容A才行（被赋值的类型属性比作为值的类型属性要少才行）。

以上就是两者的区别。

玖 ❀ 内置对象

前文我们提到，在js中其实存在很多内置对象，比如window、Date、RegExp等等，你有没有想过，假设我现在声明了一个正则表达式，那我应该添加什么类型？

其实在typescript底层已经帮我们封装好了这些类型，我们可以直接使用，看部分例子：

let a: Boolean = new Boolean(1);
let b: Error = new Error('报错啦');
let c: Date = new Date();
let d: RegExp = /'听风是风'/;

可以看到通过new一个构造器得到的实例，它们的类型都是首字母大写，正则比较特殊，不管是对象声明还是new它本身就只支持RegExp。

再比如js中内置了一些DOM以及BOM对象，比如类数组NodeList，事件对象Event等，这些也能直接用于类型定义，比如：

let div:NodeList =  document.querySelectorAll('.div');

更多内置对象类型查阅MDN，这里就不一一细说了。

拾 ❀ 总

那么到这里，我们已经快速过完了typescript基础内容，准备来说这些知识已经足以支撑看懂项目中大部分ts代码了，毕竟ts也没有太多的额外知识，更多是对于js类型的限制，后续会再利用进阶篇补全剩下概念，那么到这里全文结束。