TypeScript 初识 - 接口
接口的作用是声明变量的结构和方法,但不做具体的实现。通常,接口会强制对所有成员进行类型检查,包括数量和类型:
interface Name { first: string; second: string; } let name: Name; name = { first: 'John', second: 'Doe' }; name = { // Error: 'second is missing' first: 'John' }; name = { // Error: 'second is the wrong type' first: 'John', second: 1337 };
可选属性
带有可选属性的接口与普通的接口定义差不多,只是在可选属性名字定义的后面加一个 ?
符号:
interface Name { first?: string; second?: string; } let name: Name; name = { // 只有 first 也不会报错 first: 'John' };
只读属性
一些对象属性只能在对象刚刚创建的时候修改其值。可以在属性名前用 readonly
来指定只读属性:
interface Point { readonly x: number; readonly y: number; } let p1: Point = { x: 10, y: 20 }; p1.x = 5; // error!
TypeScript 具有 ReadonlyArray<T>
类型,它与 Array<T>
相似,只是把所有可变方法去掉了,因此可以确保数组创建后再也不能被修改:
let a: number[] = [1, 2, 3, 4]; let ro: ReadonlyArray<number> = a; ro[0] = 12; // error! ro.push(5); // error! ro.length = 100; // error! a = ro; // error!
readonly
针对一个对象的属性,const
针对的是一个变量。这两个使用场景不同。
额外的属性检查
从字面上的意思看,其实就是对接口未定义的属性进行检查。
当一个变量实现接口时,变量中存在了接口未定义的属性时,TypeScript 会进行报错:
interface Point { x: number; y?: number; } // error! const myPoint: Point = { x: 1, z: 3 };
要想绕过检查,最简单的方法就是使用类型断言:
const myPoint: Point = { x: 1, z: 3 } as Point;
最佳的方法是定义接口的时候添加一个字符串索引签名:
interface Point { x: number; y?: number; [propName: string]: any; }
函数类型
可以使用接口表示函数类型,需要给接口定义一个调用签名:
interface SearchFunc { (source: string, subString: string): boolean; } let mySearch: SearchFunc; mySearch = function(source: string, subString: string) { const result = source.indexOf(subString); return result > -1; };
和变量类型的接口不同,函数的参数名不需要与接口定义的名字相匹配。函数的参数会逐个进行检查,要求对应位置上的参数类型是兼容的:
let mySearch: SearchFunc; mySearch = function(src: string, sub: string): boolean { let result = src.indexOf(sub); return result > -1; };
如果没有指定类型,TypeScript 的类型系统会推断出参数类型,因为函数直接赋值给了 SearchFunc 类型变量:
let mySearch: SearchFunc; mySearch = function(src, sub) { let result = src.indexOf(sub); return result > -1; };
可索引的类型
可索引类型具有一个 索引签名,它描述了对象索引的类型,还有相应的索引返回值类型。
interface StringArray { [index: number]: string; } let myArray: StringArray; myArray = ['Bob', 'Fred']; let myStr: string = myArray[0];
上面的例子,定义了 StringArray
接口,它具有索引签名。这个索引签名表示了当用 number
去索引 StringArray
时会得到 string
类型的返回值。
TypeScript 支持两种索引签名:字符串和数字。可以同时使用两种类型的索引,但是数字索引的返回值必须是字符串索引返回值类型的子类型。其实,这相当于 JavaScript 对象的 key,数字类型会转换成字符串类型再取值。
字符串索引签名能够很好的描述 dictionary
模式,并且也会确保所有属性与其返回值类型相匹配:
interface NumberDictionary { [index: string]: number; length: number; // 可以,length 是 number 类型 name: string; // 错误,name 的类型与索引类型返回值的类型不匹配 }
可以将索引签名设置为只读,这样就防止了给索引赋值:
interface ReadonlyStringArray { readonly [index: number]: string; } let myArray: ReadonlyStringArray = ['Alice', 'Bob']; myArray[2] = 'Mallory'; // error!
类类型
类可以使用 implements
关键字实现某一个接口:
interface Point { x: number; y?: number; getX(): number; } class MyPoint implements Point { constructor(x: number) { this.x = x; } x: number; getX(): number { return this.x; } }
接口描述了类的公共部分,而不是公共和私有两部分。它不会帮你检查类是否具有某些私有成员。
继承接口
接口之间可以相互继承,并且一个接口还可以继承多个接口,就是将一个接口里的成员复制到另一个接口中:
interface Shape { color: string; } interface PenStroke { penWidth: number; } interface Square extends Shape, PenStroke { sideLength: number; } let square = <Square>{}; square.color = 'blue'; square.sideLength = 10; square.penWidth = 5.0;
混合类型
一个对象可以同时具有多种类型。一个例子就是,一个对象可以同时做为函数和对象使用,并带有额外的属性:
interface Counter { (start: number): string; interval: number; reset(): void; } function getCounter(): Counter { let counter = <Counter>function(start: number) {}; counter.interval = 123; counter.reset = function() {}; return counter; } let c = getCounter(); c(10); c.reset(); c.interval = 5.0;