基础类型

布尔类型

  let isActive: boolean = false;

数值类型

  let decimalValue: number = 6;

字符串类型

  let userName: string = 'jane';

无值类型

1.示例

  let emptyValue: null = null;
  let undefinedValue: undefined = undefined;

2.null/undefined是所有类型的子类型

  let variable: any = undefined;

空返回类型

1.关键字为void，只能被赋值undefined和null

  let noReturn: void = undefined;

任意类型

1.可以赋值为任意类型的值（没有类型限制）

  let flexibleValue: any = 'seven';
  flexibleValue = 7;

2.对任意值进行任何操作，返回值类型都是任意值

3.变量声明时，如果未指定类型

  a.未赋值，则会默认为any类型
    let something;
    something = 'seven';
    something = 7;
  b.赋值了，则会被类型推断为所赋值的类型
    let myValue = 'seven';
    myValue = 7;  // 会报错

联合类型

1.表示取值可以为多种类型中的一种

2.示例

  let multiTypeValue: string | number
  multiTypeValue = 'seven'
  multiTypeValue = 7

3.当不确定联合类型变量的类型时，只能访问此联合类型的所有类型里共有的属性或方法

  function convertToString(input: string | number): string {
    return input.toString()
  }

对象类型

1.对象的类型由接口定义

2.接口是对行为的抽象，而具体实现则由类去实现

3.示例代码

  interface UserProfile {
    username: string
    age: number
  }
  
  let user: UserProfile = {
    username: 'Jane',
    age: 30
  }

4.对象定义时，变量的属性数量/形状必须和接口属性数量/形状保持一致

5.可选属性

  interface UserProfile {
    username: string
    age?: number
  }

  let user: UserProfile = {
    username: 'Jane'
  }

5.可索引属性

  interface Dictionary {
    key: number
    value?: number
    [propName: string]: string
  }
  // 报错 - 确定属性和可选属性的返回值类型必须和它的返回值类型匹配，或者是它的返回值类型的子集

  class Vehicle {
    brand: string;
  }
  class Car extends Vehicle {
    model: string;
  }
  // 错误 - 可索引的属性可以多个，数字索引的返回值必须是字符串索引返回值类型的子类型
  interface NotValidIndex {
    [index: number]: Vehicle;
    [index: string]: Car;
  }

6.只读属性

  interface Config {
    readonly id: number
    version: number
  }

  let appConfig: Config = {
    id: 1001,
    version: 2.0
  }

  appConfig.id = 2002 // 报错

数组类型

1.类型+方括号表示法

  let numberArray: number[] = [1, 1, 2, 3, 5];
  let mixedArray: number[] = [1, 1, 2, 3, '5']; // 会报错
  numberArray.push('5'); // 会报错

2.数组泛型

  let fibonacciSequence: Array<number> = [1, 1, 2, 3, 5]

3.接口表示数组

  interface NumberCollection {
    [index: number]: number
  }
  let fibonacciSequence: NumberCollection = [1, 1, 2, 3, 5]

4.任意类型数组

• 用any表示数组中允许出现任意类型
• 示例

  let mixedList: any[] = ['alex', 30, { info: 'developer' }]

5.类数组

• a.常见的类数组都有自己的接口定义，如 Arguments, NodeList, HTMLCollection
• b.示例

  function calculateSum() {
    let args: Arguments = arguments
  }

函数类型

1.函数声明

• 示例

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

• 输入多余/少于要求的参数，是不被允许的

  calculateSum(1, 2, 3) // 报错
  calculateSum(1) // 报错

2.函数表达式

• 示例

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

• =>用来表示函数的定义，左边是输入类型，需要用括号括起来，右边是输出类型

3.用接口定义函数的形状

  interface SearchFunction {
    (source: string, query: string): boolean
  }

  let findText: SearchFunction = function(source, query) {
    return source.indexOf(query) !== -1
  }

4.可选参数

• 可选参数，必须接在必需参数后面
• 可选参数，后面不允许再出现必须参数

5.参数默认值

• 同ES6
• 会将添加了默认值的参数，识别为可选参数
• 不受"可选参数必须接在必需参数后面"的限制

6.剩余参数

• 同ES6

7.函数重载

• 允许一个函数接受不同数量或类型的参数时，作出不同的处理
• 示例

  function formatValue(x: number): number
  function formatValue(x: string): string
  function formatValue(x: number | string): number | string {
    if (typeof x === 'number') {
      return Number(x.toString().split('').reverse().join(''))
    } else if (typeof x === 'string') {
      return x.split('').reverse().join('');
    }
  }

• 如果多个函数定义有包含关系，需要优先把精确的定义写在前面

进阶类型

类型推断

定义

• 如果没有明确指定类型，那么TypeScript会依照类型推论规则推断出一个类型

代码示例

  let favoriteNumber = 'seven';
  favoriteNumber = 7; // 报错，因为已推断为字符串

强调

• 如果定义的时候没有赋值，会被推断成any类型

  let uninitializedValue;
  uninitializedValue = 'seven';
  uninitializedValue = 7;

类型断言

1.手动指定一个值的类型，然后才可以使用类型对应的方法，否则只能访问公共属性/方法

  function getValueLength(input: string | number): number {
    if ((<string>input).length) {
      return (<string>input).length;
    } else {
      return input.toString().length;
    }
  }

2.方法

• <类型>值
• 值 as 类型

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

  function toBoolean(input: string | number): boolean {
    return <boolean>input
  }

类型别名

定义

• 用来给一个类型起个新名字

示例代码

  type UserName = string;
  type NameGenerator = () => string;
  type NameProvider = UserName | NameGenerator;

字符串字面量类型

定义

• 用来约束取值只能是某几个字符串中的一个

示例代码

  type EventType = 'click' | 'scroll' | 'mousemove';
  function handleEvent(element: Element, event: EventType) {}

注意

• 类型别名与字符串字面量类型都是使用type进行定义

元组类型

定义

• 数组合并了相同类型的对象，而元组合并了不同类型的对象

示例

  let person: [string, number] = ['John', 30];

注意

1.当赋值或访问一个已知索引的元素时，可以只赋值其中一项

  let person: [string, number];
  person[0] = 'John';

2.直接对元祖类型赋值时，需提供所有类型项

  let person: [string, number];
  person = ['John', 30];

3.当添加越界元素时，类型会被限制为定义项的类型

  let person: [string, number];
  person = ['John', 30];
  person.push('male');
  person.push(true); // 报错

枚举类型

定义

• 用于取值被限定在一定范围内的场景

简单示例

  enum WeekDays {Sun, Mon, Tue, Wed, Thu, Fri, Sat};
  console.log(WeekDays["Sun"] === 0); // true
  console.log(WeekDays[0] === "Sun"); // true

手动赋值

  enum WeekDays {Sun = 7, Mon = 1, Tue, Wed, Thu, Fri, Sat};

  console.log(WeekDays["Sun"] === 7); // true
  console.log(WeekDays["Mon"] === 1); // true
  console.log(WeekDays["Sat"] === 6); // true

说明

• 未手动赋值的枚举项会接着上一个枚举项递增
• 未手动赋值的枚举项与手动赋值的重复了，TypeScript不会察觉，后者只会覆盖前者

枚举项类型

1.常数项和计算所得项

2.计算所得项·示例

  enum RGBColor { Red, Green, Blue = "blue".length };

3.如果紧接在计算所得项后面的是未手动赋值的项，那么它就会因为无法获得初始值而报错

  enum RGBColor { Red = "red".length, Green, Blue }; // 报错

常数枚举

1.示例代码

  const enum CompassDirection {
    North,
    South,
    East,
    West
  }

  let directions = [ CompassDirection.North, CompassDirection.South, CompassDirection.East, CompassDirection.West ];

  var directions = [0, 1, 2, 3]; //编译结果

2.常数枚举与普通枚举的区别是，它会在编译阶段被删除，并且不能包含计算所得项

const enum RGBColor {Red, Green, Blue = "blue".length};  // 报错

外部枚举

1.示例代码

  declare enum CompassDirection {
    North,
    South,
    East,
    West
  }

  let directions = [CompassDirection.North, CompassDirection.South, CompassDirection.East, CompassDirection.West];

  var directions = [CompassDirection.North, CompassDirection.South, CompassDirection.East, CompassDirection.West]; //编译结果

2.declare 定义的类型只会用于编译时的检查，编译结果中会被删除

3.外部枚举与声明语句一样，常出现在声明文件中

类

概述

• TypeScript除了实现了所有ES6中的类的功能以外，还添加了一些新的用法

修饰符

  public       	可被公开访问
  private      	仅供自身访问，子类也不可以访问它的属性/方法
  protected 	受保护的访问，子类可以访问它的属性/方法

抽象类

• 用abstract关键字定义（抽象类/抽象方法）
• 不允许被实例化
• 抽象方法必须被子类实现
• 抽象类可以包含成员的实现细节

类与接口

类实现接口

• 把各层级的类之间共有的特性提取出来进行实现的部分叫接口
• 接口通过interface定义，通过implements实现
• 一个类只能继承一个类，但是可以实现多个接口
• 接口不会帮你检查类是否具有某些私有成员
• 接口只会对类的实例部分进行类型检查

接口继承接口

• 通过extends关键字来继承
• 接口可以继承多个接口

接口继承类

• 通过extends关键字来继承
• 在接口继承类的时候，也只会继承它的实例属性和实例方法
• 接口继承了拥有私有或受保护成员的类时，这个接口只能被这个类或其子类所实现

泛型

定义

• 在定义函数、接口或类的时候，不预先指定具体的类型，而在使用的时候再指定类型的一种特性
• 示例代码

  function generateArray<T>(length: number, value: T): Array<T> {
    let result: T[] = [];
    for (let i = 0; i < length; i++) {
      result[i] = value;
    }
    return result;
  }
  generateArray<string>(3, 'hello');      // ['hello', 'hello', 'hello']

多个类型参数

  function swapValues<T, U>(pair: [T, U]): [U, T] {
    return [pair[1], pair[0]];
  }
  swapValues([7, 'seven']);     // ['seven', 7]

泛型默认类型

  function createArray<T = string>(length: number, value: T): Array<T> {
    let result: T[] = [];
    for (let i = 0; i < length; i++) {
      result[i] = value
    }
    return result;
  }

泛型约束

1.由于事先不知道它是哪种类型，所以不能随意的操作它的属性或方法

  function logValue<T>(arg: T): T {
    console.log(arg.length); // 报错
    return arg;
  }

2.对泛型进行约束

  interface Lengthwise {
    length: number;
  }
  function logValue<T extends Lengthwise>(arg: T): T {
    console.log(arg.length);
    return arg;
  }

3.泛型之间也可以相互约束

function mergeObjects<T extends U, U>(target: T, source: U): T {
    for (let prop in source) {
        target[prop] = (<T>source)[prop];
    }
    return target;
}

let obj = { a: 1, b: 2, c: 3, d: 4 };

mergeObjects(obj, { b: 10, d: 20 });

4.在泛型约束中使用类型参数

function getProperty<T, K extends keyof T> (obj: T, key: K ) {
  return obj[key]
}

let obj = {a: 1, b: 2, c: 3, d: 4}

getProperty(obj, 'a') // okay
getProperty(obj, 'm') // error

泛型接口

  写法一
  interface Processor {
    <T>(input: T): T;
  }
  function process<T>(input: T): T {
    return input;
  }
  let processor: Processor = process;
  processor<number>(1);            // 手动指定-在调用时 传递 泛型参数类型
  processor(1);                    // 类型推断-在调用时 推断 泛型参数类型

  写法二
  interface Processor<T> {
    (input: T): T;
  }
  function process<T>(input: T): T {
    return input;
  }
  let stringProcessor: Processor<string> = process;   // 接口定义了需要传递类型参数T，这里为string
  stringProcessor<string>('hello')             // 报错，因为类型定义Processor<string>已经指定
  stringProcessor(123);                  // 报错，必须符合接口Processor<string>参数类型

泛型类

  class GenericContainer<T> {
    zeroValue: T;
    add: (x: T, y: T) => T;
  }

声明文件

概要

1.使用第三方库时，需要引用它的声明文件，才能获得对应的代码补全、接口提示等功能

2.声明语句中只能定义类型，切勿在声明语句中定义具体的实现

3.示例代码

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

4.注意

• 带有声明语句的文件即为声明文件
• 声明文件必需以 .d.ts为后缀
• 如果TypeScript无法解析声明文件，检查tsconfig.json中的files、include和exclude配置，确保其包含了对应库的xx.d.ts文件

5.第三方声明文件

• 通常使用@types统一管理第三方库的声明文件
• 示例

  npm install @types/jquery --save-dev

声明合并

1.如果定义了两个相同名字的函数、接口或类，那么它们会合并成一个类型

2.合并的属性类型必须是唯一的

3.函数合并

• 参考函数重载示例

4.接口合并

  interface Device {
    price: number;
  }

  interface Device {
    weight: number; 
  }

  // 等同于
  interface Device {
    price: number;
    weight: number;
  }

5.类合并

• 与接口的合并规则一致

书写声明文件

1.声明合并

• 一个东西既可以是函数，也可以是对象(拥有子属性)
• 示例

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

2.export

• 声明文件中禁止定义具体的实现
• interface前是不需要declare的

3.export default

• 只有 function、class 和interface可以直接默认导出，其他变量需先声明，再默认导出
• 一般会将导出语句放在整个声明文件的最前面

4.commonjs规范下的export

• commonjs导出

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

• 在导入方式上，有两种跟es6语法相同
• 官推导入方式（commonjs下）

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

• 官推导出方式（commonjs下）（假如要为它写类型声明文件的话）

  export = foo
  declare function foo(): string

• 两种官推方式都是TypeScript为了兼容AMD和commonjs规范而创立的

5.UMD库的导出

  export as namespace '导出名'

6.在npm包/UMD库中扩展全局变量

  declare global {
    interface String {
      prependHello(): string
    }
  }

7.模块插件(declare module)

  // index.d.ts声明
  import * as moment from 'moment';

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

  // index.ts使用
  import * as moment from 'moment';
  import 'moment-plugin';

  moment.foo();

8.声明文件中的依赖

• 示例参考<模块插件index.d.ts声明>
• 三斜杠指令
• 早期版本中为了描述模块之间的依赖关系而创造的语法
• 使用场景：书写一个全局变量，并且需要依赖一个全局变量声明文件时
• 示例

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

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

• 三斜杠指令必须放在文件的最顶端，它前面只允许出现单行或多行注释

• 拆分声明文件

• 示例

  /// <reference types="sizzle" />
  /// <reference path="JQueryStatic.d.ts" />
  /// <reference path="JQuery.d.ts" />
  /// <reference path="misc.d.ts" />
  /// <reference path="legacy.d.ts" />
	
  export = jQuery;

• types用于声明对另一个库的依赖，path用于声明对另一个文件的依赖

9.自动生成声明文件

• 命令行
• 在命令行中添加--declaration（简写-d）
• 配置文件
• 在tsconfig.json中添加declaration选项
• 示例代码

  {
    "compilerOptions": {
      "module": "commonjs",
      "outDir": "lib",
      "declaration": true
    }
  }

发布声明文件

1.将声明文件和源码放在一起（TypeScript声明查找也遵循a=>b=>c）

• package.json中配置types或typings字段，指定声明文件
• 在项目根目录下，放置一个index.d.ts声明文件
• 针对package.json的入口文件位置，放置一个声明文件

2.将声明文件发布到@types下

• 与普通的npm模块不同，@types统一由DefinitelyTyped管理

内置对象的声明文件

• TypeScript核心库定义中，包含了所有游览器环境用到的类型（ECMAScript，DOM和BOM标准）
• TypeScript核心库定义中，不包含Nodejs部分（需要npm install @types/node --save-dev）