TS学习随笔(三)->接口
终于来到了比较重要的知识,接口,有多重要呢,反正是很重要好啵
在 TypeScript 中,我们使用接口(Interfaces)来定义对象的类型。
那什么是接口呢,在面向对象语言中,接口(Interfaces)是一个很重要的概念,它是对行为的抽象,而具体如何行动需要由类(classes)去实现(implements)。
TypeScript 中的接口是一个非常灵活的概念,除了可用于对类的一部分行为进行抽象以外,也常用于对「对象的形状(Shape)」进行描述。
少侠:这是个什么东西,看不太懂啊
机智的我:少侠,少侠我懂,你家里有锁吗(别说没有啊,没有这天就聊死了)。
少侠:有,咋的了?
机智的我:我准备用锁来给你解释一下什么是接口,锁就是接口
少侠:瞎扯,看刀!
机智的我:(躲躲躲)少侠这是真的啊,接口就像你家的锁,钥匙就像是一个个的类,要想和锁匹配打开锁,就只能根据锁里面的锁芯来实现钥匙的样子
少侠:有点意思啊
机智的我:我说的有点道理吧少侠,来让我们继续看看代码怎么实现的
//定义一个接口
interface Person { name: string; age: number; } let tom: Person = { name: 'Tom', age: 25 };
简单吧,下面让我们再看看另外两个例子
第一个例子:
interface Person { name: string; age: number; } let tom: Person = { name: 'Tom' }; // index.ts(6,5): error TS2322: Type '{ name: string; }' is not assignable to type 'Person'. // Property 'age' is missing in type '{ name: string; }'.
为啥报错了呢,因为定义的变量比接口少了一些属性是不允许的,你想要是允许,那不乱了套了吗,少了一截的钥匙都能打开锁,那我要这锁有何用?
第二个例子
interface Person { name: string; age: number; } let tom: Person = { name: 'Tom', age: 25, gender: 'male' }; // index.ts(9,5): error TS2322: Type '{ name: string; age: number; gender: string; }' is not assignable to type 'Person'. // Object literal may only specify known properties, and 'gender' does not exist in type 'Person'.
哎哟,少了不行,多了也不行吗?对的,定义的变量比接口多了一些属性也是不允许的,
可见,赋值的时候,变量的形状必须和接口的形状保持一致。就跟钥匙必须和锁芯完全匹配才可以一样一样的
少侠:这木简单,我学会了
机智的我:别急啊少侠,下面还有呢
进行下面的学习时请忘掉上面锁的例子,锁的例子只匹配最基础的接口的用法,放在下面就不合适了
有时我们希望不要完全匹配一个形状,那么可以用可选属性(?)
interface Person { name: string; age?: number; } let tom: Person = { name: 'Tom' };
interface Person { name: string; age?: number; } let tom: Person = { name: 'Tom', age: 25 };
你看,上面两种都不报错,说明我们的可选属性生效了,可选属性的含义是该属性可以不存在。
这时仍然不允许添加未定义的属性:
interface Person { name: string; age?: number; } let tom: Person = { name: 'Tom', age: 25, gender: 'male' }; // examples/playground/index.ts(9,5): error TS2322: Type '{ name: string; age: number; gender: string; }' is not assignable to type 'Person'. // Object literal may only specify known properties, and 'gender' does not exist in type 'Person'.
你看,又报错了,来我们看下解决方法
任意属性:
有时候我们希望一个接口允许有任意的属性,可以使用如下方式:
interface Person { name: string; age?: number; [propName: string]: any; } let tom: Person = { name: 'Tom', gender: 'male' };
使用 [propName: string]
定义了任意属性取 string
类型的值
需要注意的是,一旦定义了任意属性,那么确定属性和可选属性的类型都必须是它的类型的子集(特别注意)
interface Person { name: string; age?: number; [propName: string]: string; } let tom: Person = { name: 'Tom', age: 25, gender: 'male' }; // index.ts(3,5): error TS2411: Property 'age' of type 'number' is not assignable to string index type 'string'. // index.ts(7,5): error TS2322: Type '{ [x: string]: string | number; name: string; age: number; gender: string; }' is not assignable to type 'Person'. // Index signatures are incompatible. // Type 'string | number' is not assignable to type 'string'. // Type 'number' is not assignable to type 'string'.
上例中,任意属性的值允许是 string
,但是可选属性 age
的值却是 number
,number
不是 string
的子属性,所以报错了。
就是说你一旦将任意属性设置为string,那木接口里面所有属性的取值必须为string
另外,在报错信息中可以看出,此时 { name: 'Tom', age: 25, gender: 'male' }
的类型被推断成了 { [x: string]: string | number; name: string; age: number; gender: string; }
,这是联合类型和接口的结合。
只读属性:
有时候我们希望对象中的一些字段只能在创建的时候被赋值,那么可以用 readonly
定义只读属性
interface Person { readonly id: number; name: string; age?: number; [propName: string]: any; } let tom: Person = { id: 89757, name: 'Tom', gender: 'male' }; tom.id = 9527; // index.ts(14,5): error TS2540: Cannot assign to 'id' because it is a constant or a read-only property.
上例中,使用 readonly
定义的属性 id
初始化后,又被赋值了,所以报错了。
注意,只读的约束存在于第一次给对象赋值的时候,而不是第一次给只读属性赋值的时候:
interface Person { readonly id: number; name: string; age?: number; [propName: string]: any; } let tom: Person = { name: 'Tom', gender: 'male' }; tom.id = 89757; // index.ts(8,5): error TS2322: Type '{ name: string; gender: string; }' is not assignable to type 'Person'. // Property 'id' is missing in type '{ name: string; gender: string; }'. // index.ts(13,5): error TS2540: Cannot assign to 'id' because it is a constant or a read-only property.
上例中,报错信息有两处,第一处是在对 tom
进行赋值的时候,没有给 id
赋值。
第二处是在给 tom.id
赋值的时候,由于它是只读属性,所以报错了。
参考资料:https://github.com/xcatliu/typescript-tutorial/blob/master/basics/type-of-object-interfaces.md