TypeScript 初识 - 接口

Cincan

2019-08-22

接口的作用是声明变量的结构和方法，但不做具体的实现。通常，接口会强制对所有成员进行类型检查，包括数量和类型：

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;

typescript