接口的作用是声明变量的结构和方法,但不做具体的实现。通常,接口会强制对所有成员进行类型检查,包括数量和类型:
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
类型,它与 Array
相似,只是把所有可变方法去掉了,因此可以确保数组创建后再也不能被修改:
let a: number[] = [1, 2, 3, 4];
let ro: ReadonlyArray = 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.color = 'blue';
square.sideLength = 10;
square.penWidth = 5.0;
混合类型
一个对象可以同时具有多种类型。一个例子就是,一个对象可以同时做为函数和对象使用,并带有额外的属性:
interface Counter {
(start: number): string;
interval: number;
reset(): void;
}
function getCounter(): Counter {
let counter = function(start: number) {};
counter.interval = 123;
counter.reset = function() {};
return counter;
}
let c = getCounter();
c(10);
c.reset();
c.interval = 5.0;