Null 和 Undefined

  1. let u: undefined = undefined;
  2. let j: number | undefined; // undefined 常用于组合类型
  3. let n: null = null;
  4. // undefined 和 null 是所有类型的子类型。也就是说 undefined 类型的变量,可以赋值给 number 类型的变量
  5. // 这样不会报错
  6. let num: number = u;

但是如果指定了 —strictNullChecks 严格空校验,null 和 undefined 只能赋值给 void 和它们各自,不然会报错。

  1. let age: number = null
  2. let realName: string = undefined

image.png

number 数值

  1. let decLiteral: number = 6;
  2. let hexLiteral: number = 0xf00d;
  3. // ES6 中的二进制表示法
  4. let binaryLiteral: number = 0b1010;
  5. // ES6 中的八进制表示法
  6. let octalLiteral: number = 0o744;
  7. let notANumber: number = NaN;
  8. let infinityNumber: number = Infinity;

boolean 布尔

  1. let isDone: boolean = false;
  2. // 使用构造函数 Boolean 创造的对象不是布尔值,事实上 new Boolean() 返回的是一个 Boolean 对象
  3. let createdByNewBoolean: Boolean = new Boolean(1);

string 字符串

  1. let myName: string = 'Tom';
  2. let myAge: number = 25;
  3. // 模板字符串
  4. let sentence: string = `Hello, my name is ${myName}.
  5. I'll be ${myAge + 1} years old next month.`;

类型推论

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

以下代码虽然没有指定类型,但是会在编译的时候报错:

  1. let myFavoriteNumber = 'seven';
  2. myFavoriteNumber = 7;
  3. // index.ts(2,1): error TS2322: Type 'number' is not assignable to type 'string'.

事实上,它等价于:

  1. let myFavoriteNumber: string = 'seven';
  2. myFavoriteNumber = 7;
  3. // index.ts(2,1): error TS2322: Type 'number' is not assignable to type 'string'.

TypeScript 会在没有明确的指定类型的时候推测出一个类型,这就是类型推论。
如果定义的时候没有赋值,不管之后有没有赋值,都会被推断成 **any** 类型而完全不被类型检查

  1. let myFavoriteNumber;
  2. myFavoriteNumber = 'seven';
  3. myFavoriteNumber = 7;

any 任意类型

普通类型,在赋值过程中改变类型是不被允许的,如果是 any 类型,则允许被赋值为任意类型

  1. let myFavoriteNumber: any = 'seven';
  2. myFavoriteNumber = 7;

在任意值上访问任何属性都是允许的:

  1. let anyThing: any = 'hello';
  2. console.log(anyThing.myName);
  3. console.log(anyThing.myName.firstName);

也允许调用任何方法:

  1. let anyThing: any = 'Tom';
  2. anyThing.setName('Jerry');
  3. anyThing.setName('Jerry').sayHello();
  4. anyThing.myName.setFirstName('Cat');

可以认为,声明一个变量为任意值之后,对它的任何操作,返回的内容的类型都是任意值

变量如果在声明的时候,未指定其类型,那么它会被识别为任意值类型

  1. let something;
  2. something = 'seven';
  3. something = 7;
  4. something.setName('Tom');

等价于

  1. let something: any;
  2. something = 'seven';
  3. something = 7;
  4. something.setName('Tom'

不建议使用 any,不然就丧失了 TS 的意义,用到 any,就意味着放弃类型检查了,因为它不是用来描述具体类型的。

在使用它之前,我们需要想两件事:

  1. 能否使用更具体的类型
  2. 能否使用 unknown 代替

都不能的情况下,any 才是最后的选择。

unknown 任意类型

不建议使用 any,当我不知道一个类型具体是什么时,该怎么办?

可以使用 unknown 类型

unknown 类型代表任何类型,它的定义和 any 定义很像,但是它是一个安全类型,使用 unknown 做任何事情都是不合法的。 相当于是安全版本的 any 类型

比如,这样一个 divide 函数,

  1. function divide(param: any) {
  2. return param / 2
  3. }

把 param 定义为 any 类型,TS 就能编译通过,没有把潜在的风险暴露出来,万一传的不是 number 类型,不就没有达到预期了吗。

把 param 定义为 unknown 类型 ,TS 编译器就能拦住潜在风险,如下图,

  1. function divide(param: unknown) {
  2. return param / 2
  3. }

image.png

因为不知道 param 的类型,使用运算符 /,导致报错。

再配合类型断言,即可解决这个问题,

  1. function divide(param: unknown) {
  2. // 1.类型断言 —— 不飘红,但执行时可能错误
  3. return param as number / 2
  4. // 2、类型守卫 —— 不飘红,且确保正常执行
  5. if (typeof param === 'number') {
  6. // 推断出类型: number
  7. return param / 2
  8. }
  9. // 3、类型断言函数,抛出错误 —— 不飘红,且确保正常执行
  10. assertIsNumber(param);
  11. return param / 2
  12. }
  13. /** 类型断言函数,抛出错误 */
  14. function assertIsNumber(arg: unknown): asserts arg is Number {
  15. if (!(arg instanceof Number)) {
  16. thrownewTypeError('Not a Number: ' + arg);
  17. }
  18. }

使用 any 好比鬼屋探险,代码执行的时候处处见鬼。而 unknown 结合类型守卫等方式,可以确保上游数据结构不确定时,也能让代码正常执行。

void 空值 指定方法类型

void 类型与 any 类型相反,它表示没有任何类型。

在 TypeScript 中,可以用 void 表示没有任何返回值的函数,方法体中不能return

  1. function alertName(): void {
  2. alert('My name is Tom');
  3. }
  4. // 声明一个 void 类型的变量没有什么用,因为你只能将它赋值为 undefined 和 null:
  5. let unusable: void = undefined;

联合类型

简单使用

表示取值可以为多种类型中的一种 联合类型使用 | 分隔每个类型。

  1. let UnionTypesr: string | number;

访问联合类型的属性或方法

当 TypeScript 不确定一个联合类型的变量到底是哪个类型的时候,我们只能访问此联合类型的所有类型里共有的属性或方法

  1. function getLength(something: string | number): number {
  2. return something.length;
  3. }
  4. // index.ts(2,22): error TS2339: Property 'length' does not exist on type 'string | number'.
  5. // Property 'length' does not exist on type 'number'.

上例中,length 不是 stringnumber 的共有属性,所以会报错。
访问 stringnumber 的共有属性是没问题的:

  1. function getString(something: string | number): string {
  2. return something.toString();
  3. }

联合类型的变量在被赋值的时候,会根据类型推论的规则推断出一个类型:

  1. let myFavoriteNumber: string | number;
  2. myFavoriteNumber = 'seven';
  3. console.log(myFavoriteNumber.length); // 5
  4. myFavoriteNumber = 7;
  5. console.log(myFavoriteNumber.length); // 编译时报错
  6. // index.ts(5,30): error TS2339: Property 'length' does not exist on type 'number'.

上例中,第二行的 myFavoriteNumber 被推断成了 string,访问它的 length 属性不会报错。
而第四行的 myFavoriteNumber 被推断成了 number,访问它的 length 属性时就报错了。

type 类型别名

类型别名用来给一个类型起个新名字。

  1. type Name = string;
  2. type NameResolver = () => string;
  3. type NameOrResolver = Name | NameResolver;
  4. function getName(n: NameOrResolver): Name {
  5. if (typeof n === 'string') {
  6. return n;
  7. } else {
  8. return n();
  9. }
  10. }

上例中,我们使用 type 创建类型别名。
类型别名常用于联合类型。

对象的类型 — Interfaces 接口

在 TypeScript 中,我们使用接口(Interfaces)来定义对象的类型

在面向对象语言中,接口(Interfaces)是一个很重要的概念,它是对行为的抽象,而具体如何行动需要由类(classes)去实现(implement)。

TypeScript 中的接口是一个非常灵活的概念,除了可用于对类的一部分行为进行抽象以外,也常用于对「对象的形状(Shape)」进行描述。

简单例子

  1. interface Person {
  2. readonly id: number; //只读属性
  3. name: string;
  4. age?: number; //可选属性
  5. [propName: string]: any; //任意属性
  6. }
  7. let tom: Person = {
  8. id: 8978958,
  9. name: 'Tom',
  10. age: 25,
  11. gender: 'male'
  12. };
  13. interface ObjectType<T> {
  14. [key: string]: T
  15. }
  16. function isObjectLike(value: any): value is ObjectType<any>{
  17. // ...
  18. }

上面的例子中,我们定义了一个接口 Person,接着定义了一个变量 tom,它的类型是 Person。这样,我们就约束了 tom 的形状必须和接口 Person 一致。

首字母大写 形状一致

接口一般首字母大写
赋值的时候,变量的形状必须和接口的形状保持一致。
定义的变量比接口少了一些属性是不允许的:

  1. interface Person {
  2. name: string;
  3. age: number;
  4. }
  5. let tom: Person = {
  6. name: 'Tom'
  7. };
  8. // index.ts(6,5): error TS2322: Type '{ name: string; }' is not assignable to type 'Person'.
  9. // Property 'age' is missing in type '{ name: string; }'.

多一些属性也是不允许的:

  1. interface Person {
  2. name: string;
  3. age: number;
  4. }
  5. let tom: Person = {
  6. name: 'Tom',
  7. age: 25,
  8. gender: 'male'
  9. };
  10. // index.ts(9,5): error TS2322: Type '{ name: string; age: number; gender: string; }' is not assignable to type 'Person'.
  11. // Object literal may only specify known properties, and 'gender' does not exist in type 'Person'.

可选属性

有时我们希望不要完全匹配一个形状,那么可以用可选属性:

  1. interface Person {
  2. name: string;
  3. age?: number;
  4. }
  5. let tom: Person = {
  6. name: 'Tom'
  7. };
  1. interface Person {
  2. name: string;
  3. age?: number;
  4. }
  5. let tom: Person = {
  6. name: 'Tom',
  7. age: 25
  8. };

可选属性的含义是该属性可以不存在。
这时仍然不允许添加未定义的属性:

  1. interface Person {
  2. name: string;
  3. age?: number;
  4. }
  5. let tom: Person = {
  6. name: 'Tom',
  7. age: 25,
  8. gender: 'male'
  9. };
  10. // examples/playground/index.ts(9,5): error TS2322: Type '{ name: string; age: number; gender: string; }' is not assignable to type 'Person'.
  11. // Object literal may only specify known properties, and 'gender' does not exist in type 'Person'

任意属性

有时候我们希望一个接口允许有任意的属性,可以使用如下方式:

  1. interface Person {
  2. name: string;
  3. age?: number;
  4. [propName: string]: any;
  5. }
  6. let tom: Person = {
  7. name: 'Tom',
  8. gender: 'male'
  9. };

使用 [propName: string] 定义了任意属性取 string 类型的值。
需要注意的是,一旦定义了任意属性,那么确定属性和可选属性的类型都必须是它的类型的子集

  1. interface Person {
  2. name: string;
  3. age?: number;
  4. [propName: string]: string;
  5. }
  6. let tom: Person = {
  7. name: 'Tom',
  8. age: 25,
  9. gender: 'male'
  10. };
  11. // index.ts(3,5): error TS2411: Property 'age' of type 'number' is not assignable to string index type 'string'.
  12. // index.ts(7,5): error TS2322: Type '{ [x: string]: string | number; name: string; age: number; gender: string; }' is not assignable to type 'Person'.
  13. // Index signatures are incompatible.
  14. // Type 'string | number' is not assignable to type 'string'.
  15. // Type 'number' is not assignable to type 'string'.

上例中,任意属性的值允许是 string,但是可选属性 age 的值却是 numbernumber 不是 string 的子属性,所以报错了。

另外,在报错信息中可以看出,此时 { name: 'Tom', age: 25, gender: 'male' } 的类型被推断成了 { [x: string]: string | number; name: string; age: number; gender: string; },这是联合类型和接口的结合。

一个接口中只能定义一个任意属性。如果接口中有多个类型的属性,则可以在任意属性中使用联合类型

  1. interface Person {
  2. name: string;
  3. age?: number;
  4. [propName: string]: string | number;
  5. }
  6. let tom: Person = {
  7. name: 'Tom',
  8. age: 25,
  9. gender: 'male'
  10. };

只读属性

有时候我们希望对象中的一些字段只能在创建的时候被赋值,那么可以用 readonly 定义只读属性:

  1. interface Person {
  2. readonly id: number;
  3. name: string;
  4. age?: number;
  5. [propName: string]: any;
  6. }
  7. let tom: Person = {
  8. id: 89757,
  9. name: 'Tom',
  10. gender: 'male'
  11. };
  12. tom.id = 9527;
  13. // index.ts(14,5): error TS2540: Cannot assign to 'id' because it is a constant or a read-only property.

上例中,使用 readonly 定义的属性 id 初始化后,又被赋值了,所以报错了。
注意,只读的约束存在于第一次给对象赋值的时候,而不是第一次给只读属性赋值的时候

  1. interface Person {
  2. readonly id: number;
  3. name: string;
  4. age?: number;
  5. [propName: string]: any;
  6. }
  7. let tom: Person = {
  8. name: 'Tom',
  9. gender: 'male'
  10. };
  11. tom.id = 89757;
  12. // index.ts(8,5): error TS2322: Type '{ name: string; gender: string; }' is not assignable to type 'Person'.
  13. // Property 'id' is missing in type '{ name: string; gender: string; }'.
  14. // index.ts(13,5): error TS2540: Cannot assign to 'id' because it is a constant or a read-only property.

上例中,报错信息有两处,第一处是在对 tom 进行赋值的时候,没有给 id 赋值。
第二处是在给 tom.id 赋值的时候,由于它是只读属性,所以报错了。

数组类型

在 TypeScript 中,数组类型有多种定义方式,比较灵活。

简单使用

  1. // 「类型 + 方括号」表示法
  2. let array1: number[] = [1, 1, 2, 3, 5];
  3. // 数组泛型
  4. let array2: Array<number> = [1, 1, 2, 3, 5];
  5. // 用接口表示数组
  6. interface NumberArray {
  7. [index: number]: number;
  8. }
  9. let fibonacci: NumberArray = [1, 1, 2, 3, 5];
  10. // 类数组
  11. // any在数组中的应用 用 any 表示数组中允许出现任意类型
  12. let list: any[] = ['xcatliu', 25, { website: 'http://xcatliu.com' }];

「类型 + 方括号」表示法

最简单的方法是使用「类型 + 方括号」来表示数组:

  1. let fibonacci: number[] = [1, 1, 2, 3, 5];

数组的项中不允许出现其他的类型:

  1. let fibonacci: number[] = [1, '1', 2, 3, 5];
  2. // Type 'string' is not assignable to type 'number'.

数组的一些方法的参数也会根据数组在定义时约定的类型进行限制:

  1. let fibonacci: number[] = [1, 1, 2, 3, 5];
  2. fibonacci.push('8');
  3. // Argument of type '"8"' is not assignable to parameter of type 'number'.

上例中,push 方法只允许传入 number 类型的参数,但是却传了一个 "8" 类型的参数,所以报错了。这里 "8" 是一个字符串字面量类型,会在后续章节中详细介绍。

元组类型

元组类型允许表示一个已知元素数量和类型的数组,各元素的类型不必相同。

  1. // 元组 数组合并了相同类型的对象,而元组(Tuple)合并了不同类型的对象。
  2. let Tom: [string, number] = ['Tom', 25]
  3. Tom.push(100) // 可以使用数组方法,但只能 push 定义的 number 或者 string 类型

enum 枚举类型

  1. // 枚举 枚举(Enum)类型用于取值被限定在一定范围内的场景,比如一周只能有七天,颜色限定为红绿蓝等。
  2. enum Days {Sun, Mon, Tue, Wed, Thu, Fri, Sat};
  3. console.log(Days["Sun"] === 0); // true
  4. console.log(Days["Mon"] === 1); // true
  5. console.log(Days["Tue"] === 2); // true
  6. console.log(Days["Sat"] === 6); // true
  7. console.log(Days[0] === "Sun"); // true
  8. console.log(Days[1] === "Mon"); // true
  9. console.log(Days[2] === "Tue"); // true
  10. console.log(Days[6] === "Sat"); // true

DOM 和 BOM

  1. let body: HTMLElement = document.body
  2. let allDiv: NodeList = document.querySelectorAll('div');
  3. document.addEventListener('click', (e: MouseEvent) => {
  4. e.preventDefault()
  5. // Do something
  6. });