类型别名

  • 类型别名用来给一个类型起个新名字。
  • 使用 type 创建类名。
1
2
3
4
5
6
7
8
9
10
type Name = string;
type NameResolver = () => string;
type NameOrResolver = Name | NameResolver;
function getName(n: NameOrResolver): Name {
if (typeof n === 'string') {
return n;
} else {
return n();
}
}

字符串字面量类型

  • 字符串字面量类型用来约束取值只能是某几个字符串中的一个。
  • 类型别名与字符串字面量类型都是使用 type 进行定义。
1
2
3
4
5
6
7
8
9
type EventNames = 'click' | 'scroll' | 'mousemove';
function handleEvent(ele: Element, event: EventNames) {
// do something
}

handleEvent(document.getElementById('hello'), 'scroll'); // 没问题
handleEvent(document.getElementById('world'), 'dblclick'); // 报错,event 不能为 'dblclick'

// index.ts(7,47): error TS2345: Argument of type '"dblclick"' is not assignable to parameter of type 'EventNames'.

元组

  • 数组合并了相同类型的对象,而元组(Tuple)合并了不同类型的对象。
  • 使用[]表示。
  • 当直接对元组类型的变量进行初始化或者赋值的时候,需要提供所有元组类型中指定的项
1
let tom: [string, number] = ['Tom', 25];

当添加越界的元素时,它的类型会被限制为元组中每个类型的联合类型:

1
2
3
4
5
6
let tom: [string, number];
tom = ['Tom', 25];
tom.push('male');
tom.push(true);

// Argument of type 'true' is not assignable to parameter of type 'string | number'.

枚举

  • 枚举(Enum)类型用于取值被限定在一定范围内的场景,比如一周只能有七天,颜色限定为红绿蓝等。
  • 枚举使用 enum 关键字来定义。
  • 枚举成员会被赋值为从 0 开始递增的数字,同时也会对枚举值到枚举名进行反向映射。
1
2
3
4
5
6
7
8
9
10
11
enum Days {Sun, Mon, Tue, Wed, Thu, Fri, Sat};

console.log(Days["Sun"] === 0); // true
console.log(Days["Mon"] === 1); // true
console.log(Days["Tue"] === 2); // true
console.log(Days["Sat"] === 6); // true

console.log(Days[0] === "Sun"); // true
console.log(Days[1] === "Mon"); // true
console.log(Days[2] === "Tue"); // true
console.log(Days[6] === "Sat"); // true

手动赋值

  • 使用手动赋值的时候需要注意,最好不要出现这种覆盖的情况。
  • 手动赋值的枚举项可以不是数字,此时需要使用类型断言来让 tsc 无视类型检查。
  • 手动赋值的枚举项也可以为小数或负数,此时后续未手动赋值的项的递增步长仍为 1:
1
2
3
4
5
6
enum Days {Sun = 7, Mon = 1.5, Tue, Wed, Thu, Fri, Sat};

console.log(Days["Sun"] === 7); // true
console.log(Days["Mon"] === 1.5); // true
console.log(Days["Tue"] === 2.5); // true
console.log(Days["Sat"] === 6.5); // tru

常数项和计算所得项

  • 当满足以下条件时,枚举成员被当作是常数:
    • 不具有初始化函数并且之前的枚举成员是常数。在这种情况下,当前枚举成员的值为上一个枚举成员的值加 1。但第一个枚举元素是个例外。如果它没有初始化方法,那么它的初始值为 0。
    • 枚举成员使用常数枚举表达式初始化。常数枚举表达式是 TypeScript 表达式的子集,它可以在编译阶段求值。当一个表达式满足下面条件之一时,它就是一个常数枚举表达式:
      • 数字字面量
      • 引用之前定义的常数枚举成员(可以是在不同的枚举类型中定义的)如果这个成员是在同一个枚举类型中定义的,可以使用非限定名来引用
      • 带括号的常数枚举表达式
      • +, -, ~ 一元运算符应用于常数枚举表达式
      • +, -, *, /, %, <<, >>, >>>, &, |, ^ 二元运算符,常数枚举表达式做为其一个操作对象。若常数枚举表达式求值后为 NaN 或 Infinity,则会在编译阶段报错
  • 所有其它情况的枚举成员被当作是需要计算得出的值。

常数枚举

  • 使用const enum定义的枚举类型。
  • 常数枚举与普通枚举的区别是,它会在编译阶段被删除,并且不能包含计算成员。
  • 假如包含了计算成员,则会在编译阶段报错。

外部枚举

  • 使用 declare enum 定义的枚举类型。
  • 外部枚举与声明语句一样,常出现在声明文件中。
  • 同时使用 declare 和 const 也是可以的
1
2
3
4
5
6
7
8
declare const enum Directions {
Up,
Down,
Left,
Right
}

let directions = [Directions.Up, Directions.Down, Directions.Left, Directions.Right];

声明合并

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

函数的合并

1
2
3
4
5
6
7
8
9
function reverse(x: number): number;
function reverse(x: string): string;
function reverse(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('');
}
}

接口合并

  • 接口中的属性在合并时会简单的合并到一个接口中,但合并的属性的类型必须是唯一的
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
interface Alarm {
price: number;
alert(s: string): string;
}
interface Alarm {
price: number;
weight: number;
alert(s: string, n: number): string;
}

// 相当于

interface Alarm {
price: number;
weight: number;
alert(s: string): string;
alert(s: string, n: number): string;
}

类的合并

  • 与接口的合并规则相同。