TypeScript 是 JavaScript 的类型的超集，它可以编译成纯 JavaScript。编译出来的 JavaScript 可以运行在任何浏览器上。TypeScript 编译工具可以运行在任何服务器和任何系统上。TypeScript 是开源的。

以下内容均出自于 TS入门教程

以及 Ts 官网的一些内容，没有基础的小伙伴直接看打了⭐️的内容即可。

尝试

看了之后怎么搭个环境写一写？

mkdir demo
cd demo
touch 1.ts

打开vscode，打开控制台，切换到问题 tab

欧了，开始尝试 ts 吧

⭐️基础类型

└boolean

let isDone: boolean = false;
// 使用构造函数 Boolean 创造的对象不是布尔值

└null & undefined

是所有类型的子类型

void类型不能赋值给 number

let u: undefined = undefined;
let n: null = null;
let num: number = undefined;
let u: undefined;
let num: number = u;

└void 类型

一般表示函数没有返回值。用在变量上没有什么卵用。

function warnUser(): void {
    console.log("This is my warning message");
}
let a: void = undefined
let a: void = 'undefined' // 报错，这是字符串

跟它相似的类型还有undefined 和 null 在不开启严格空检查的情况下 --strictNullChecks，他们可以赋值给所有已经定义过***其他类型***的变量。也就是说他们是所有类型的子类型

let a: undefined = undefined
let a: null = null

└数字 number

TypeScript里的所有数字都是浮点数。这些浮点数的类型是 number。支持十进制和十六进制字面量二进制和八进制字面量。

let decLiteral: number = 6;
let hexLiteral: number = 0xf00d;
// ES6 中的二进制表示法
let binaryLiteral: number = 0b1010;
// ES6 中的八进制表示法
let octalLiteral: number = 0o744;
let notANumber: number = NaN;
let infinityNumber: number = Infinity;

└字符串 string

单双引'' ""，模板字符的都被视为字符串

let str:string = ''

⭐️数组类型

有多种声明数组的方式

最简单的方法是使用类型 + []来表示数组：

const arr: number[] = [1,2,3]
const arr2: string[] = ['1','2']

数组泛型定义方式

const arr2: Array<number> = [1,2,3,3]
const arr2: Array<string> = [1,2,3,3]

接口表示数组

interface NumArr {
    [index: number]: number;
}
let numArr: NumArr = [1,2,3];

any 类型数组

let list:any[] = [1,"z",{}]

元组类型声明

// 表示一个确定数组长度和类型的写法
const arr:[string,number] = ['2',3]

类数组

就是伪数组的定义

官方已给了各自的定义接口 Arguments, NodeList, HTMLCollection

function sum() {
    let args: IArguments = arguments;
}

枚举 enum

js中没有这类型，仿照强类型语言来的。值只能为数字，不定义默认值得情况为从0开始。

enum Color {Red, Green, Blue}
let c: Color = Color.Green;
// c = 1

enum Number {one = 10, two}
let c: Number = Number.two;
// c = 11

⭐️any 类型(任意值)

指代所有的类型

let a: any = '123'
let a = 123; // 不声明默认 any

never

表示永远不存在的值,一般会用来写抛出异常或推断为返回值为never的函数。（比如return一个其他的never类型）

function error(message: string): never {
    throw new Error(message);
}
error('a')

object 类型

非简单类型也就是除number，string，boolean，symbol，null或undefined之外的类型。

function create(o: object | null): void{
  console.log(o);
};
create({ prop: 0 }); // OK
create(null); // OK
create([]); // OK
create('a'); // error

⭐️interface 接口

在 TypeScript 中，我们使用接口（Interfaces）来定义对象的类型。

对对象的描述

接口一般首字母大写。

赋值的时候，变量必须和接口保持一致。

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

let tom: Person = {
    name: 'Tom',
    age: 25
};

└可选属性

不想完全匹配某个接口,通过?表示这个属性是可选的

仍然不允许添加未定义的属性

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

let tom: Person = {
    name: 'Tom'
};

└任意属性

让接口允许添加任意的属性值

[propName: string]: any;

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

let tom: Person = {
    name: 'Tom',
    gender: 'male'
};

一旦定义了任意属性，那么确定属性和?可选属性都必须是任意属性的子集

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

let p:Person = {
    name: 'zzc',
    age: 12, // error ， 定义了 propName 必须将值设定为 string 类型
    gender: 'male' ,
}

└只读属性 readonly

相当于是常量了，初次赋值后不能重新赋值做为变量使用的话用 const，若做为属性则使用readonly。

interface demo {
  readonly a: string; // readonly定以后不能改值
  b: number
}
let obj: demo = {
  a: 'ss',
  b: 1
}
obj.a = 'aa' // error
obj.b = 2 // success

只读的约束存在于第一次给对象赋值的时候，而不是第一次给只读属性赋值的时候

interface Person {
    readonly id: number;
}
const tom: Person = {} // error
tom.id = 1 // error,

会报两次错，第一个是因为指定了 id，但没有给 id 赋值

第二个错是给只读属性id赋值了

└ReadonlyArray

通过ReadonlyArray定义的数组，再也无法改变了。

let a: number[] = [1, 2, 3, 4];
let ro: ReadonlyArray<number> = [1,2,3];
a[0] = 10 // success
ro[0] = 12; // error!
ro.push(5); // error!
ro.length = 100; // error!
a = ro; // 注意！ 将readonly的值赋值给一个可变得数组也是不行的。
a = ro as Array<any> // 但是可以用断言重写

⭐️函数类型

常见的函数声明方式有：函数声明 & 函数表达式

用 ts 定义函数要考虑它的输入和输出

函数声明方式定义

function sum(a:number,b:number):number{
    return a+b
}
// 形参和实参数量要一致
sum(1) // error
sum(1,2) //3
sum(1,2,3) // error

函数表达式定义

// 方式 1
let sum = function(a:number,b:number):number {
    return a + b;
}
// 方式二
let sum: (x: number, y: number) => number = function (x: number, y: number): number {
    return x + y;
};

方式一中只对等号右侧的匿名函数定义了类型，左边是ts通过类型推论定义出来的

方式二才是给 sum 定义类型，**其中的 => 不是 es6的 => ** ,它用来表示函数的定义，左边是输入类型，需要用括号括起来，右边是输出类型。

因为和 es6箭头函数可能造成混淆，最好用方式一；

└可选参数

通过?给函数定义可选参数

可选参数后面不允许再出现必须参数了

如果给参数添加了默认值，ts 会自动识别为可选，且不受上一条规则的限制。

function sum(a:number,b?:number){}
function sum(a?:number,b:number){} // error
function sum(a:number = 1,b:number){} // 默认值，识别为可选，且不报错

└...rest

使用…rest获取剩余参数，使用数组类型去定义它

剩余参数必须是函数的最后一个参数

function (a, ...items:any[]){}
function (...items:any[], a){} // error

└函数的重载

重载允许一个函数接受不同数量或类型的参数时，作出不同的处理。

可以重复定义一个函数的类型

function say(somthing:string):string;
function say(somthing:number):string;
// 以上是函数定义

// 以下是函数实现
function say(somthing:string|number):string|number {
    return somthing
}

注意，TypeScript 会优先从最前面的函数定义开始匹配，所以多个函数定义如果有包含关系，需要优先把精确的定义写在前面。

⭐️类型断言

类型断言（Type Assertion）可以用来手动指定一个值的类型。

断定这个变量的类型是啥

类型断言不是类型转换

两种写法

<类型>值 or 值 as 类型

如果在 tsx 语法中使用，必须用 as

例子

联合类型可以指定一个变量为多种类型，此变量只能访问类型们的共有方法。

但一些情况下我们必须使用某一类型的方法或属性时，就可以用断言

function say(something:number|string):void{
    alert(something.length) // 联合类型，报错
}
// ==> 使用断言, 在变量前加上 <类型>
function say(something:number|string):void{
    alert( (<string>something).length ) // success
}

断言成一个联合类型中不存在的类型是不允许的

function say(something:number|string):void{
    alert(<boolean>something.length) // 联合类型没有 boolean ,error
}

⭐️declare 声明

第三方库会暴露出一个变量，让我们在项目中直接使用。

但是 ts 编译时不知道这是啥，编译无法通过。

此时我们就要用 declare var 声明语句来定义他的类型

 // 比如 jquery
$('div') // ERROR: Cannot find name 'jQuery'.

// ==> 使用 declare var 第三方库变量: (参数: string) => 返回类型
declare var $: (selector: string) => any;

$('#foo'); // success

declare var 并不是真正的声明一个变量，编译完会删除，仅仅是定义类型。

└声明文件

通常我们会把声明语句放到一个单独的文件（*.d.ts）中，这就是声明文件

声明文件必需以 .d.ts 为后缀

假如仍然无法解析，那么可以检查下 tsconfig.json 中的 files、include 和 exclude 配置，确保其包含了 jQuery.d.ts 文件。

// src/jQuery.d.ts

declare var jQuery: (selector: string) => any;

这只是非模块化项目中使用的例子

└第三方声明文件

当然，jQuery 的声明文件不需要我们定义了，社区已经帮我们定义好了：jQuery in DefinitelyTyped。

我们可以直接下载下来使用，但是更推荐的是使用 @types 统一管理第三方库的声明文件。

@types 的使用方式很简单，直接用 npm 安装对应的声明模块即可，以 jQuery 举例：

npm i @types/jquery -D

可以在这个页面搜索你需要的声明文件。

└自定义声明文件

声明文件有以下方法

全局变量：通过 <script> 标签引入第三方库，注入全局变量

npm 包：通过 import foo from 'foo' 导入，符合 ES6 模块规范

UMD 库：既可以通过 <script> 标签引入，又可以通过 import 导入

模块插件：通过 import 导入后，可以改变另一个模块的结构

直接扩展全局变量：通过 <script> 标签引入后，改变一个全局变量的结构。比如为 String.prototype 新增了一个方法

通过导入扩展全局变量：通过 import 导入后，可以改变一个全局变量的结构

这里只记录 npm 导入的方法, 其他请看书写声明文件

在给一个第三方库写声明文件之前，先查看这个库有没有声明文件。一般来说，npm 包的声明文件可能存在于两个地方：

跟 npm 包绑在一起, package.json 中有type 字段，或者有 index.d.ts 声明文件。一般常用的包都有了，自己要发布 npm 包的时候最好也绑定在一起。
发布到了@types](http://microsoft.github.io/TypeSearch/) 里,一般这种情况是作者没写，其他人写了发上去的。npm install @types/foo --save-dev 直接通过安装。

如果都没有，才自己写。

声明文件存放的位置是有约束的，一般在两个位置。

在node_modules 创建第三方库的声明文件，但这种一般不采纳。一般 node_modules 不会随我们的应用发布到服务器|git上。
创建一个types 目录来写，要配合tsconfig.json 来使用。

# 项目结构
├── README.md
├── src
|  └── index.ts
├── types
|  └── foo
|     └── index.d.ts
└── tsconfig.json

配置

{
    "compilerOptions": {
        "module": "commonjs",
        "baseUrl": "./",
        "paths": {
            "*" : ["types/*"]
        }
    }
}

不管采用了以上两种方式中的哪一种，我都强烈建议大家将书写好的声明文件（通过给原作者发 pr，或者直接提交到 @types 里）发布到开源社区中，享受了这么多社区的优秀的资源，就应该在力所能及的时候给出一些回馈。只有所有人都参与进来，才能让 ts 社区更加繁荣。

export

npm 包写的声明文件 declare 不会声明一个全局变量，只有导出的时候才会应用类型声明。

export const name: string; // 简单类型
export function getName(): string; // 函数
export class Animal { // class 声明
    constructor(name: string);
    sayHi(): string;
}

export interface Options { // 接口
    data: any;
}

// ===> 对应使用到项目中
import { name, getName, Animal, Directions, Options } from 'foo';
let myName = getName();
let cat = new Animal('Tom');
let options: Options = {
    data: {
        name: 'foo'
    }
}

混用 declare export

通过 declare 定义多个变量，一次性导出

declare const name: string;
declare function getName(): string;
declare class Animal {
    constructor(name: string);
    sayHi(): string;
}

export {
	name,
    getName,
    Animal,
}

导出默认值

只有 function、class 和 interface 可以直接默认导出，其他的变量需要先定义出来，再默认导出

针对默认导出，一般会把导出语句烦恼歌在声明文件的最前面。

export default function foo(): string;
export default interface Options {
    data: any
}
export default class Person {
    constructor(name: string);
    sayHi(): string;
}
declare const str:string;
export default str;

export namespace

namespace 本来是 TS 的模块化方案，随着 es6越来越屌基本已经不在 ts 中使用了。

但是声明文件中还是很常用的，表示变量是一个包含了子属性的对象类型。

像是lodash ,它是个对象，但提供了很多子属性方法如 lodash.debunce

如果对象拥有深层的层级，则需要用嵌套的 namespace 来声明深层的属性的类型：

总的来说,用来导出一个拥有子属性的对象。

export namespace obj {
    const name: string;
    function fn(a:string,b?:nnumber):void;
    class Event {
        say(str:string):void
    };
    // 如果还有包含子属性的对象，就嵌套
    namespace sonObj {
        const foo: string;
    }
}

└声明合并

当一个变量，既是函数又是对象。可以组合多个语句声明。

export function objAndFn(foo:string):any;
export namespace objAndFn {
    function fn(boo:number):void;
    const name:string;
}

└针对 `commonjs` 规范

用以下方式来导出：

// 整体导出
module.exports = foo;
// 单个导出
exports.bar = bar;

在 ts 中，针对这种导出，有多种方式可以导入，第一种方式是 const ... = require：

// 整体导入
const foo = require('foo');
// 单个导入
const bar = require('foo').bar;

第二种方式是 import ... from，注意针对整体导出，需要使用 import * as 来导入：

// 整体导入
import * as foo from 'foo';
// 单个导入
import { bar } from 'foo';

第三种方式是 import ... require，这也是 ts 官方推荐的方式：

// 整体导入
import foo = require('foo');
// 单个导入
import bar = require('foo').bar;

对于 commonjs 规范的库，需要使用 export = 变量 的语法写声明文件

准确地讲，export = 不仅可以用在声明文件中，也可以用在普通的 ts 文件中。实际上，import ... require 和 export = 都是 ts 为了兼容 AMD 规范和 commonjs 规范而创立的新语法

export = foo;
declare function foo():string;
declare namespace foo {
    const bar: nnumber;
}

⭐️内置对象

TS定义了 js 中内置对象的类型，在 TypeScript 核心库的定义文件中。

包括 ECMAscript、DOM、Bom 等

这些内置对象的类型在.ts 中都可以直接使用

let b: Boolean = new Boolean(1);
let e: Error = new Error('Error occurred');
let d: Date = new Date();
let r: RegExp = /[a-z]/;
let body: HTMLElement = document.body;
let allDiv: NodeList = document.querySelectorAll('div');
document.addEventListener('click', function(e: MouseEvent) {
  // Do something
});

还会在该内置对象中定位错误

Math.pow(10, '2'); // error 必须是两个 number 型
document.addEventListener('click', function(e) {
    console.log(e.targetCurrent);
    // error,  MouseEvent 类型不存在 targetCurrent属性
});

内置对象不包含 Node ，如果要使用

npm install @types/node --save-dev

类

这章是介绍面向对象编程

class Greeter {
    greeting: string;
    constructor(message: string) {
        this.greeting = message;
        console.log(this.greeting); // world
    }
    greet() {
        return "Hello, " + this.greeting;
    }
}
let greeter = new Greeter("world");

继承

基本继承作为基类的类一般被叫做超类，继承的类叫做派生类

class Car {
  name: string = '大众';
  by() {
    console.log(this.name);
  }
}
class Baoma extends Car {
  name: string = '宝马'
}
let bm = new Baoma()
bm.by()

在子类constructor构造函数中***必须调用一下super***，它会执行基类的构造函数在子类constructor构造函数调用this之前必须先调用super

class FClass {
  name: string = '超类'
  constructor(name: string) { this.name = name; }
  setAge(age:number) {
    console.log(`${this.name} is ${age}`);
  }
}
class SClass extends FClass {
  constructor(name:string) {
    super(name)
  }
}
let f = new SClass('zzc')
f.setAge(20)

公共，私有与受保护的修饰符

public可以被除自己之外的所以子类访问到 ts中所有成员默认为public 当一个成员被标记成private 时，无法被外部访问如果类的constructor声明成了private那就没办法new 和继承了。 protected 受保护的，跟private基本一样，但它在子类中可以访问；

class FClass {
  name: string = '超类'
  private constructor(name: string) { this.name = name; }
  setAge(age:number) {
    console.log(`${this.name} is ${age}`);
  }
}
let f = new FClass() // error
class Son extends FClass {} // error

protected 受保护的例子

class F {
  protected name: string;
  constructor(name: string) { this.name = name; }
  setAge(age:number) {
    console.log(`${this.name} is ${age}`);
  }
}
class Son extends F {
  constructor() {
    super('son')
  }
  getName() {
    super.name // 可以在子类访问
  }
}

let f = new F('super class')
let s = new Son()

console.log(s.name); // 不能在外部访问
console.log(s.getName()); // 但可以通过子类的方法return出来获取到

在类中使用readonly

在类中或者constructor都还可以更改readonly的值，但在外部就无法更改了。

class F {
  readonly a:number = 8
  constructor(age:number) {
    this.a = age
  }
}
let f = new F(9)
f.a = 10 // error 无法在外部更改

参数属性

在constructor用一句话定义并赋值一个属性只要在参数前面加了访问限定符就可以直接给一个属性直接赋值 readonly protected public private static 是私有的,所以不能加。

class F {
  readonly a:number = 8
  constructor(readonly b:number) {
    b = 10
  }
}
let f = new F(9)

console.log(f); // {a,b}

存取器 getter/setters

当一个属性只有get方法的时候，它就是只读的。这也是一种外部改变静态属性的方法

// 当a = 'a' 时，内部的_a才会等于赋的值，否则报错。
class F {
  private _a:string;
  get a():string {
    return this._a
  }
  set a(newA:string) {
    if(newA === 'a') {
      this._a = newA
    }
    else {
      this._a = 'error'
    }
  }
}
let f = new F()

f.a = 'b'
console.log(f);

静态属性 static

它只挂在class本身，而不是通过new实例化后出来的对象所以你可以通过 类.static属性 来调用，但不能用this

class F {
    static num: number;
    changeStatic() {
      F.num = 19;
    }
    constructor () {
      this.changeStatic()
      console.log(F.num);
    }
}
let f = new F();

抽象类 & abstract

abstract 用来定义抽象类和在抽象类中定义抽象方法的抽象类就是派生类的一个模板类，一般不会把它实例化，只是给子类继承用的。

abstract class Animal { // 抽象一个Animal类
    abstract makeSound(): void;  // 抽象一个方法，必须在子类实现它
    move(): void {
        console.log('roaming the earch...');
    }
    constructor () {

    }
}
class Son extends Animal {
  constructor() {
    super()
  }
  makeSound() { // 必须实现抽象类中的方法
    return false
  }
  haha() {
    console.log('error');
    
  }
}

let s:Animal // 可以指定抽象类为一个类型
s.haha() // 如果上面的声明了，那么调用抽象类中不存在的haha方法是不允许

s = new Animal() // 不可以new 抽象类
s = new Son()  //  正确
s.makeSound() // 正确

⭐类型推论

如果没有明确的指定类型，那么 TypeScript 会依照类型推论（Type Inference）的规则推断出一个类型。

let myFavoriteNumber = 'seven';
myFavoriteNumber = 7; // error

// 等价于 ==>
let myFavoriteNumber: string = 'seven';
myFavoriteNumber = 7;

如果定义的时候没有赋值，不管之后有没有赋值，都会被推断成 any 类型而完全不被类型检查：

let myFavoriteNumber;
myFavoriteNumber = 'seven';
myFavoriteNumber = 7;

⭐️联合类型

表示变量可以是多种类型其中的一种

通过 | 分隔

let numOrStr : string | number;
numOrStr = 7;
numOrStr = '7';
numOrStr = true; // false

当调用联合类型的方法时，只能调用俩类型中共有的方法。

let numOrStr : string | number;
numOrStr.length // 报错  length 不是 number 的方法
numOrStr.toString() // 可以