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;

相关推荐